Skip to main content

XAppCaptureOpenScreenshotStream

스크린샷 스트림을 엽니다.

구문

매개 변수

localId   _In_
형식: char*
XAppCaptureTakeScreenshot 호출 후 XAppCaptureTakeScreenshotResult에서 반환된 스크린샷의 로컬 ID입니다. screenshotFormat   _In_
형식: XAppCaptureScreenshotFormatFlag
XAppCaptureTakeScreenshot 호출 후 XAppCaptureTakeScreenshotResult에서 반환된 스크린샷 형식 플래그입니다. handle   _Out_
형식: XAppCaptureScreenshotStreamHandle*
스트림을 여는 결과로 반환되는 스크린샷 스트림 핸들입니다. totalBytes   _Out_opt_
형식: uint64_t*
스트림의 총 바이트 수입니다.

반환 값

형식: HRESULT 함수 결과입니다.

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
스크린샷은 게임 파티션에서 접근할 수 없으므로 사용자 또는 XAppCaptureTakeScreenshot으로 촬영한 스크린샷을 검색하려면 스트림을 열어야 합니다. XAppCaptureTakeScreenshot은 결과에서 localID를 반환하며, 이 함수에서 해당 스크린샷을 검색하는 데 사용됩니다. localID는 스크린샷이 디스크에 유지되는 한 유효합니다. 콘솔에서 스크린샷을 저장하는 공간은 제한되어 있습니다. 할당된 공간이 가득 차면 오래된 스크린샷이 삭제됩니다. 이로 인해 스크린샷 열기 함수가 localID를 찾지 못할 수 있습니다. 스트림을 연 후에는 XAppCaptureReadScreenShotStream으로 스크린샷을 읽을 수 있습니다. 마지막으로 메모리 누수를 방지하기 위해 모든 스트림은 XAppCaptureCloseScreenshotStream으로 닫아야 합니다.

요구 사항

헤더: XAppCapture.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 설명서

함께 보기

GameDVR 개요
XAppCapture 멤버
XAppCaptureReadScreenShotStream
XAppCaptureTakeScreenshot
XAppCaptureCloseScreenshotStream
마지막 수정일 2026년 8월 24일