Skip to main content

XAppCaptureOpenScreenshotStream

Abre una secuencia de captura de pantalla.

Sintaxis

Parámetros

localId   _In_
Tipo: char*
Id. local de la captura de pantalla devuelto en XAppCaptureTakeScreenshotResult después de llamar a XAppCaptureTakeScreenshot. screenshotFormat   _In_
Tipo: XAppCaptureScreenshotFormatFlag
Marca de formato de captura de pantalla devuelta en XAppCaptureTakeScreenshotResult después de llamar a XAppCaptureTakeScreenshot. handle   _Out_
Tipo: XAppCaptureScreenshotStreamHandle*
Identificador de la secuencia de captura de pantalla devuelto como resultado de abrir la secuencia. totalBytes   _Out_opt_
Tipo: uint64_t*
Número total de bytes de la secuencia.

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.
No es posible acceder a las capturas de pantalla desde la partición del juego, por lo que debe abrir una secuencia para recuperar las capturas de pantalla realizadas por el usuario o con XAppCaptureTakeScreenshot. XAppCaptureTakeScreenshot devuelve un localID en su resultado, que se usa en esta función para recuperar la captura de pantalla correcta. El localID será válido mientras la captura de pantalla se conserve en el disco. Solo hay una cantidad limitada de espacio en la consola en el que se almacenan las capturas de pantalla. Las capturas de pantalla más antiguas se eliminarán cuando se llene el espacio asignado. Esto podría provocar que la función de apertura de capturas de pantalla no encuentre un localID. Después de abrir la secuencia, puede leer la captura de pantalla con XAppCaptureReadScreenShotStream. Por último, cada secuencia debe cerrarse 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
XAppCaptureReadScreenShotStream
XAppCaptureTakeScreenshot
XAppCaptureCloseScreenshotStream
Última modificación el 28 de agosto de 2026