> ## 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.

# XtfCaptureRecordedGameClip

> XtfCaptureRecordedGameClip

# XtfCaptureRecordedGameClip

Recupera un clip de vídeo del GameDVR del juego que se está ejecutando actualmente.

## Sintaxis

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

### Parámetros

*address*\
Tipo: PCWSTR

\[in] La dirección IP de la consola.

*fullFileName*\
Tipo: PCWSTR

\[in] La ruta de acceso completa y el nombre del archivo en el que se escribirá el vídeo.

*numSeconds*\
Tipo: UINT32

\[in] El número de segundos de vídeo que se van a recuperar. El valor mínimo es 6 segundos. El valor máximo es 300 segundos.

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se realiza correctamente; de lo contrario, devuelve un código de error. Entre los posibles códigos de error se incluyen los siguientes:

| Código de error | Descripción |
| - | - |
| 0x82323001 | El servicio GameDVR se cerró inesperadamente. |
| 0x82323002 | No hay suficiente espacio de almacenamiento para guardar otro clip. |
| 0x82323003 | StartRecordAsync no finalizó o no se llamó desde esta instancia de ApplicationClipCapture antes de llamar a StopRecordAsync. |
| 0x82323004 | Hay demasiadas grabaciones simultáneas. |
| 0x82323005 | El texto de la respuesta HTTP es demasiado grande. |
| 0x82323006 | Falta información sobre una llamada anterior a StartRecordingAsync. |
| 0x82323007 | No se llamó a StopRecordAsync dentro del tiempo asignado después de StartRecordAsync. |
| 0x82323008 | La llamada asincrónica falló pero no devolvió un código de error. |
| 0x82323009 | Se intentó actualizar un clip en la nube cuyo identificador de nube no está disponible. |
| 0x8232300A | Se produjo un error al escribir en el archivo. |
| 0x8232300B | No se encontraron fotogramas para grabar. Entre las posibles causas se incluyen:<ul><li>El juego estaba en segundo plano durante el período de tiempo especificado.</li><li>La grabación se solicitó demasiado pronto después de activar el juego.</li></ul> |
| 0x8232300C | No se encontraron fotogramas para grabar. Entre las posibles causas se incluyen:<ul><li>El juego estaba en segundo plano durante el período de tiempo especificado.</li><li>El juego no se estaba ejecutando durante el período de tiempo especificado.</li></ul> |
| 0x8232300D | Los metadatos del clip tienen un formato incorrecto. |
| 0x8232300E | La hora de inicio es demasiado antigua o está demasiado lejos en el futuro. |
| 0x8232300F | La duración de la grabación es demasiado corta o demasiado larga. (6 - 300 segundos) |
| 0x82323010 | El usuario o el título no tiene acceso al clip especificado. |
| 0x82323011 | No hay ningún campo que actualizar. |
| 0x82323012 | La grabación estaba deshabilitada durante el período de tiempo solicitado. |
| 0x82323013 | Se llamó a StartRecordAsync mientras se estaba realizando otra grabación. |
| 0x82323014 | Se llamó a StopRecordAsync pero no se había iniciado ninguna grabación. |
| 0x82323015 | Se llamó a RecordTimespanAsync mientras se estaba realizando otra grabación. |
| 0x82323016 | Hubo un retraso al cargar el clip. La carga se volverá a intentar más adelante. Los juegos pueden ignorar este error sin problema, o usarlo para informar al usuario de que la solicitud sigue en la cola pero tardará más tiempo en completarse. |
| 0x82323017 | O bien no hay ningún título en ejecución o el título no tiene las credenciales adecuadas. |
| 0x82323018 | El título actual ha bloqueado la grabación. |
| 0x82323019 | El clip aún no se ha cargado en la nube. |
| 0x8232301A | Se especificó un usuario invitado para una operación que no lo permite. |
| 0x8232301B | El GameDVR no está disponible porque hay una difusión en curso. |
| 0x8C11040D | El título no se está ejecutando en la consola de destino. |

## Comentarios

Mientras se ejecuta un juego, la consola almacena automáticamente hasta 300 segundos de vídeo en un búfer de vídeo FIFO. `XtfCaptureRecordedGameClip` recupera del búfer la cantidad especificada de vídeo almacenado previamente y lo guarda en el archivo especificado en `fullFileName`. El archivo se guarda en el formato de vídeo MP4. Para obtener más información sobre el uso de GameDVR para capturar clips de vídeo, consulte [GameDVR y difusión](https://docs.xbox.com/es/build/console-features/game-dvr/gamedvr-broadcast.md).

## Requisitos

**Encabezado:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

## Consulte también

[XtfCaptureScreenshot](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot.md)\
[Errores de transporte de XTF (tema con NDA)](https://docs.xbox.com/es/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[API de Xtf adicionales](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [API de Xtf adicionales (contenido de la API)](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XAppCaptureRecordClipResult](https://docs.xbox.com/es/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)
- [XAppCaptureRecordDiagnosticClip](https://docs.xbox.com/es/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md)
- [GameClip (JSON)](https://docs.xbox.com/es/reference/live/rest/json/json-gameclip.md)
- [XAppCaptureStartUserRecord](https://docs.xbox.com/es/reference/system/xappcapture/functions/xappcapturestartuserrecord.md)