Skip to main content

XAppCaptureOpenScreenshotStream

Abre um fluxo de captura de tela.

Sintaxe

Parâmetros

localId   _In_
Tipo: char*
ID local da captura de tela retornada em XAppCaptureTakeScreenshotResult após chamar XAppCaptureTakeScreenshot. screenshotFormat   _In_
Tipo: XAppCaptureScreenshotFormatFlag
Sinalizador de formato da captura de tela retornado em XAppCaptureTakeScreenshotResult após chamar XAppCaptureTakeScreenshot. handle   _Out_
Tipo: XAppCaptureScreenshotStreamHandle*
Identificador do fluxo de captura de tela retornado como resultado da abertura do fluxo. totalBytes   _Out_opt_
Tipo: uint64_t*
Número total de bytes no fluxo.

Valor retornado

Tipo: HRESULT Resultado da função.

Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, confira Threads sensíveis ao tempo.
As capturas de tela não podem ser acessadas a partir da partição do jogo; portanto, você deve abrir um fluxo para recuperar as capturas de tela feitas pelo usuário ou com XAppCaptureTakeScreenshot. XAppCaptureTakeScreenshot retorna uma localID em seu resultado, que é usada nesta função para recuperar a captura de tela correta. A localID será válida enquanto a captura de tela for mantida no disco. Há apenas uma quantidade limitada de espaço no console para armazenar capturas de tela. As capturas de tela mais antigas serão excluídas quando o espaço reservado estiver cheio. Isso pode fazer com que a função de abertura de captura de tela não encontre uma localID. Depois de abrir o fluxo, você pode ler a captura de tela com XAppCaptureReadScreenShotStream. Por fim, todo fluxo precisa ser fechado com XAppCaptureCloseScreenshotStream para evitar um vazamento de memória.

Requisitos

Cabeçalho: XAppCapture.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

Visão geral do GameDVR
Membros de XAppCapture
XAppCaptureReadScreenShotStream
XAppCaptureTakeScreenshot
XAppCaptureCloseScreenshotStream
Last modified on October 6, 2026