XtfCaptureRecordedGameClip

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

Sintaxe

HRESULT XtfCaptureRecordedGameClip(
         PCWSTR address,
         PCWSTR fullFileName,
         UINT32 numSeconds
)  

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.

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: O jogo estava em segundo plano durante o período especificado. A gravação foi solicitada logo após a ativação do jogo.
0x8232300C	Nenhum quadro foi encontrado para gravação. As causas possíveis incluem: O jogo estava em segundo plano durante o período especificado. O jogo não estava em execução durante o período especificado.
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.

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.

Requisitos

Cabeçalho: xtfapi.h Biblioteca: XtfApi.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

Confira também

XtfCaptureScreenshot
Erros de transporte do XTF (tópico sob NDA)
APIs adicionais do Xtf

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XtfCaptureRecordedGameClip

XtfCaptureRecordedGameClip

Sintaxe

Parâmetros

Valor de retorno

Comentários

Requisitos

Confira também

​XtfCaptureRecordedGameClip

​Sintaxe

​Parâmetros

​Valor de retorno

​Comentários

​Requisitos

​Confira também

XtfCaptureRecordedGameClip

Sintaxe

Parâmetros

Valor de retorno

Comentários

Requisitos

Confira também