Skip to main content

XAppCaptureStartUserRecord

Grava como se o usuário a tivesse disparado. Se o jogador suspender/restringir o jogo enquanto uma gravação estiver em andamento, a gravação será interrompida. A gravação é salva na partição do usuário. As configurações de captura se baseiam nas configurações do GameDVR. Depois que o limite de gravações simultâneas for atingido, será necessário chamar XAppCaptureStopUserRecord ou XAppCaptureCancelUserRecord antes que outra gravação possa ser iniciada. O suporte do Windows para esta API será adicionado em uma versão futura.

Sintaxe

Parâmetros

requestingUser _In_
Tipo: XUserHandle
Identificador que representa o usuário que está solicitando a gravação. localIdBufferLength _In_
Tipo: uint32_t
O comprimento do buffer que recebe a ID local da gravação. localIdBuffer _Out_
Tipo: char*
Buffer que contém a ID local que especifica a operação de gravação em andamento.

Valor retornado

Tipo: HRESULT Resultado da função. Consulte Códigos de erro de XAppCapture para valores retornados diferentes de S_OK.

Comentários

Na conclusão bem-sucedida da função, localIdOfUserRecording contém a ID local da gravação, que deve ser armazenada para interromper uma gravação específica com XAppCaptureStopUserRecord ou XAppCaptureCancelUserRecord.
Os clipes mais antigos serão excluídos quando o espaço alocado estiver cheio, para abrir espaço para novos clipes. Use PLS (Persistent Local Storage), o armazenamento conectado (por exemplo, XGameSave ou XGameSaveFiles) ou um sistema de armazenamento semelhante para reter clipes por um período de tempo definido.

Requisitos

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

Confira também

Membros de XAppCapture
Last modified on October 6, 2026