> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAppCaptureScreenshotStream

> XAppCaptureScreenshotStream

# XAppCaptureScreenshotStream

Representa um fluxo de captura de tela.

## Sintaxe

```cpp theme={null}
typedef struct XAppCaptureScreenshotStream {  
} XAppCaptureScreenshotStream  
```

### Membros

Esta estrutura não contém membros de dados.

## Comentários

Use esta estrutura para coletar capturas de tela.

Você pode fazer uma captura de tela do jogo chamando [XAppCaptureTakeScreenshot](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturetakescreenshot.md).

`XAppCaptureTakeScreenshot` retorna uma ou mais IDs locais, que você pode usar para recuperar uma captura de tela passando-a em uma chamada para [XAppCaptureOpenScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md). Você obterá duas IDs locais se fizer uma captura de uma tela HDR: uma para a versão SDR e outra para a versão HDR.

`XAppCaptureOpenScreenshotStream` retorna um identificador para o objeto `XAppCaptureScreenshotStream`. Você pode usar esse identificador para ler o conteúdo do fluxo passando-o em uma chamada para [XAppCaptureReadScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md).

Quando terminar, feche o identificador chamando [XAppCaptureCloseScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream.md).

## Exemplo

O exemplo de código a seguir demonstra como gravar o conteúdo do fluxo de captura de tela em um arquivo local.

```cpp theme={null}
void WriteScreenshotStreamToFile(_In_ const char* screenshotLocalId, _In_ XAppCaptureScreenshotFormatFlag screenshotFormat, _In_ const char* filePath)
{
    const int MAX_DATA = 1024;
    XAppCaptureScreenshotStreamHandle handle = nullptr;
    BYTE buffer[MAX_DATA];
    HANDLE file = INVALID_HANDLE_VALUE;
    UINT64 totalBytesRead = 0;
    UINT64 totalBytesToRead = 0;

    if (FAILED_LOG(XAppCaptureOpenScreenshotStream(screenshotLocalId, screenshotFormat, &handle, &totalBytesToRead)))
    {
        return;
    }

    appLog.AddLog("%I64d bytes returned\n", totalBytesToRead);

    file = CreateFileA(filePath, GENERIC_READ | GENERIC_WRITE, 0, 0, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, 0);
    if (file == INVALID_HANDLE_VALUE)
    {
        appLog.AddLog("Could not create %s\n", filePath);
        goto Cleanup;
    }

    while (totalBytesRead < totalBytesToRead)
    {
        uint32_t bytesRead = 0;
        DWORD bytesWritten = 0;

        if (FAILED_LOG(XAppCaptureReadScreenshotStream(handle, totalBytesRead, sizeof(buffer), buffer, &bytesRead)))
        {
            goto Cleanup;
        }

        BOOL result = WriteFile(file, buffer, bytesRead, &bytesWritten, NULL );
        if (!result)
        {
            appLog.AddLog("Failed to write to %s\n", filePath);
            goto Cleanup;
        }

        totalBytesRead += bytesRead;
    }

Cleanup:
    if (handle != nullptr)
    {
        FAILED_LOG(XAppCaptureCloseScreenshotStream(handle));
    }
    if (file != INVALID_HANDLE_VALUE)
    {
        CloseHandle(file);
    }
    appLog.AddLog("Wrote out %I64d bytes to %s\n", totalBytesRead, filePath);

}

```

## Requisitos

**Cabeçalho:** XAppCapture.h

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Membros de XAppCapture](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_members.md)\
[XAppCaptureTakeScreenshot](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturetakescreenshot.md)\
[xappcapturescreenshotformatflag](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturescreenshotformatflag.md)


## Related topics

- [XAppCapture (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureOpenScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)
- [XAppCaptureReadScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md)
- [XAppCaptureCloseScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream.md)
- [XAppCaptureTakeScreenshot](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturetakescreenshot.md)