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

# XtfCaptureRecordedGameClip

> XtfCaptureRecordedGameClip

# XtfCaptureRecordedGameClip

Recupera um clipe de vídeo do GameDVR do jogo em execução no momento.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT XtfCaptureRecordedGameClip(
         PCWSTR address,
         PCWSTR fullFileName,
         UINT32 numSeconds
)  
```

<a id="parametersSection" />

### Parâmetros

*address*\
Tipo: PCWSTR

\[in] O endereço IP do console.

*fullFileName*\
Tipo: PCWSTR

\[in] O caminho completo e o nome do arquivo no qual o vídeo será gravado.

*numSeconds*\
Tipo: UINT32

\[in] O número de segundos de vídeo a serem recuperados. O valor mínimo é 6 segundos. O valor máximo é 300 segundos.

<a id="retvalSection" />

### Valor de retorno

Tipo: HRESULT

Retorna `S_OK` se tiver êxito; caso contrário, retorna um código de erro. Os códigos de erro possíveis incluem os seguintes:

| Código de erro | Descrição |
| - | - |
| 0x82323001 | O serviço GameDVR foi desligado inesperadamente. |
| 0x82323002 | Não há espaço de armazenamento suficiente para salvar outro clipe. |
| 0x82323003 | StartRecordAsync não foi concluído ou não foi chamado a partir desta instância de ApplicationClipCapture antes de chamar StopRecordAsync. |
| 0x82323004 | Há muitas gravações simultâneas. |
| 0x82323005 | O texto da resposta HTTP é muito grande. |
| 0x82323006 | Estão faltando informações sobre uma chamada anterior a StartRecordingAsync. |
| 0x82323007 | StopRecordAsync não foi chamado dentro do tempo permitido após StartRecordAsync. |
| 0x82323008 | A chamada assíncrona falhou, mas não retornou um código de erro. |
| 0x82323009 | Houve uma tentativa de atualização em um clipe na nuvem cuja ID de nuvem não está disponível. |
| 0x8232300A | Ocorreu um erro ao gravar no arquivo. |
| 0x8232300B | Nenhum quadro foi encontrado para gravação. As causas possíveis incluem:<ul><li>O jogo estava em segundo plano durante o período especificado.</li><li>A gravação foi solicitada logo após a ativação do jogo.</li></ul> |
| 0x8232300C | Nenhum quadro foi encontrado para gravação. As causas possíveis incluem:<ul><li>O jogo estava em segundo plano durante o período especificado.</li><li>O jogo não estava em execução durante o período especificado.</li></ul> |
| 0x8232300D | Os metadados do clipe estão formatados incorretamente. |
| 0x8232300E | A hora de início é muito antiga ou muito distante no futuro. |
| 0x8232300F | A duração da gravação é muito curta ou muito longa. (6 a 300 segundos) |
| 0x82323010 | O usuário ou título não tem acesso ao clipe especificado. |
| 0x82323011 | Não há nenhum campo para atualizar. |
| 0x82323012 | A gravação foi desabilitada durante o período solicitado. |
| 0x82323013 | StartRecordAsync foi chamado enquanto outra gravação estava sendo feita. |
| 0x82323014 | StopRecordAsync foi chamado, mas nenhuma gravação foi iniciada. |
| 0x82323015 | RecordTimespanAsync foi chamado enquanto outra gravação estava sendo feita. |
| 0x82323016 | Houve um atraso no carregamento do clipe. O carregamento será tentado novamente mais tarde. Os jogos podem ignorar esse erro com segurança ou usá-lo para informar ao usuário que a solicitação ainda está na fila, mas levará mais tempo para ser concluída. |
| 0x82323017 | Não há nenhum título em execução ou o título não tem as credenciais adequadas. |
| 0x82323018 | O título atual bloqueou a gravação. |
| 0x82323019 | O clipe ainda não foi carregado na nuvem. |
| 0x8232301A | Um usuário convidado foi especificado para uma operação que não permite isso. |
| 0x8232301B | O GameDVR não está disponível porque há uma transmissão em andamento. |
| 0x8C11040D | O título não está em execução no console de destino. |

<a id="remarksSection" />

## Comentários

Enquanto um jogo está em execução, o console armazena automaticamente até 300 segundos de vídeo em um buffer de vídeo FIFO. `XtfCaptureRecordedGameClip` recupera do buffer a quantidade especificada de vídeo armazenado anteriormente e o armazena no arquivo especificado em `fullFileName`. O arquivo é salvo no formato de vídeo MP4. Para obter mais informações sobre como usar o GameDVR para capturar clipes de vídeo, confira [GameDVR e transmissão](/pt-BR/build/console-features/game-dvr/gamedvr-broadcast).

<a id="requirements" />

## Requisitos

**Cabeçalho:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

<a id="seealsoSection" />

## Confira também

[XtfCaptureScreenshot](/pt-BR/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot)\
[Erros de transporte do XTF (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors)\
[APIs adicionais do Xtf](/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XAppCaptureRecordClipResult](/pt-BR/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)
- [XAppCaptureRecordDiagnosticClip](/pt-BR/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md)
- [XAppCaptureVideoEncoding](/pt-BR/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [XtfCaptureScreenshot](/pt-BR/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot.md)
- [XAppCapture](/pt-BR/reference/system/xappcapture/xappcapture_members.md)