Skip to main content

XAppCaptureReadScreenshotStream

Lee una secuencia de captura de pantalla.

Sintaxis

Parámetros

handle   _In_
Tipo: XAppCaptureScreenshotStreamHandle
Identificador de la secuencia de captura de pantalla devuelto al llamar a XAppCaptureOpenScreenshotStream. startPosition   _In_
Tipo: uint64_t
Posición de la secuencia en la que se comienza a leer. bytesToRead   _In_
Tipo: uint32_t
Número de bytes de la secuencia que se van a leer. buffer   _Out_writes_to_(bytesToRead,bytesWritten)
Tipo: uint8_t
Búfer que contendrá los bytes leídos por XAppCaptureReadScreenshotStream. bytesWritten   _Out_
Tipo: uint32_t*
Número de bytes escritos realmente en el buffer.

Valor devuelto

Tipo: HRESULT Resultado de la función.

Comentarios

No es seguro llamar a esta función en un subproceso con restricciones de tiempo. Para obtener más información, consulte Subprocesos con restricciones de tiempo.
Antes de leer una captura de pantalla, debe abrir una secuencia de captura de pantalla con XAppCaptureOpenScreenShotStream. Esto generará el XAppCaptureScreenshotStreamHandle necesario para el parámetro handle. Después puede llamar a esta función para leer la captura de pantalla. Los parámetros startPosition y bytesToRead le permitirán leer una sección de la captura de pantalla, lo cual resulta útil para leer una secuencia grande sección por sección. Puede obtener el tamaño total de la secuencia a partir del parámetro de salida totalBytes de XAppCaptureOpenScreenShotStream. Los parámetros de salida buffer y bytesWritten le ayudarán a leer con precisión los datos devueltos por esta función. Después de leer los datos de la captura de pantalla, cierre la secuencia de captura de pantalla con XAppCaptureCloseScreenshotStream para evitar una fuga de memoria.

Requisitos

Encabezado: XAppCapture.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

Información general de GameDVR
Miembros de XAppCapture
XAppCaptureOpenScreenShotStream
XAppCaptureTakeScreenshot
XAppCaptureCloseScreenshotStream
Última modificación el 28 de agosto de 2026