Skip to main content

XAppCaptureReadScreenshotStream

스크린샷 스트림을 읽습니다.

구문

매개 변수

handle   _In_
형식: XAppCaptureScreenshotStreamHandle
XAppCaptureOpenScreenshotStream을 호출하여 반환된 스크린샷 스트림 핸들입니다. startPosition   _In_
형식: uint64_t
스트림에서 읽기를 시작할 위치입니다. bytesToRead   _In_
형식: uint32_t
스트림에서 읽을 바이트 수입니다. buffer   _Out_writes_to_(bytesToRead,bytesWritten)
형식: uint8_t
XAppCaptureReadScreenshotStream이 읽은 바이트를 포함할 버퍼입니다. bytesWritten   _Out_
형식: uint32_t*
실제로 buffer에 쓴 바이트 수입니다.

반환 값

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

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
스크린샷을 읽기 전에 XAppCaptureOpenScreenShotStream으로 스크린샷 스트림을 열어야 합니다. 이렇게 하면 handle 매개 변수에 필요한 XAppCaptureScreenshotStreamHandle이 생성됩니다. 그런 다음 이 함수를 호출하여 스크린샷을 읽을 수 있습니다. startPositionbytesToRead 매개 변수를 사용하면 스크린샷의 일부를 읽을 수 있으며, 이는 큰 스트림을 한 번에 한 섹션씩 읽을 때 유용합니다. XAppCaptureOpenScreenShotStreamtotalBytes 출력 매개 변수에서 스트림의 총 크기를 얻을 수 있습니다. 출력 매개 변수 bufferbytesWritten은 이 함수에서 반환된 데이터를 정확하게 읽는 데 도움이 됩니다. 스크린샷 데이터를 읽은 후에는 메모리 누수를 방지하기 위해 XAppCaptureCloseScreenshotStream으로 스크린샷 스트림을 닫습니다.

요구 사항

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

개념 설명서

함께 보기

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