Skip to main content

XAppCaptureReadScreenshotStream

Lê um fluxo de captura de tela.

Sintaxe

Parâmetros

handle   _In_
Tipo: XAppCaptureScreenshotStreamHandle
Identificador do fluxo de captura de tela retornado pela chamada de XAppCaptureOpenScreenshotStream. startPosition   _In_
Tipo: uint64_t
Posição no fluxo em que a leitura deve começar. bytesToRead   _In_
Tipo: uint32_t
Número de bytes do fluxo a serem lidos. buffer   _Out_writes_to_(bytesToRead,bytesWritten)
Tipo: uint8_t
Buffer que conterá os bytes lidos por XAppCaptureReadScreenshotStream. bytesWritten   _Out_
Tipo: uint32_t*
Número de bytes realmente gravados no buffer.

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.
Antes de ler uma captura de tela, você deve abrir um fluxo de captura de tela com XAppCaptureOpenScreenShotStream. Isso produzirá o XAppCaptureScreenshotStreamHandle necessário para o parâmetro handle. Em seguida, você pode chamar esta função para ler a captura de tela. Os parâmetros startPosition e bytesToRead permitem ler uma seção da captura de tela, o que é útil para ler um fluxo grande uma seção por vez. Você pode obter o tamanho total do fluxo pelo parâmetro de saída totalBytes em XAppCaptureOpenScreenShotStream. Os parâmetros de saída buffer e bytesWritten ajudarão você a ler com precisão os dados retornados por esta função. Depois de ler os dados da captura de tela, feche o fluxo de captura de tela 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
XAppCaptureOpenScreenShotStream
XAppCaptureTakeScreenshot
XAppCaptureCloseScreenshotStream
Last modified on October 6, 2026