> ## 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 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: | | 0x8232300C | No se encontraron fotogramas para grabar. Entre las posibles causas se incluyen: | | 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](/build/console-features/game-dvr/gamedvr-broadcast). ## Requisitos **Encabezado:** xtfapi.h **Biblioteca:** XtfApi.lib **Plataformas compatibles:** Windows (para herramientas de consola XBOX) ## Consulte también [XtfCaptureScreenshot](/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot)\ [Errores de transporte de XTF (tema con NDA)](/tools/tools-console/commandlinetools/xtf-transport-errors)\ [API de Xtf adicionales](/reference/tools/xtf/xtfapi/atoc-xtfapi) ## Related topics - [XAppCaptureRecordClipResult](/es/reference/system/xappcapture/structs/xappcapturerecordclipresult.md) - [XAppCaptureRecordDiagnosticClip](/es/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md) - [XAppCaptureStartUserRecord](/es/reference/system/xappcapture/functions/xappcapturestartuserrecord.md) - [XAppCapture](/es/reference/system/xappcapture/xappcapture_members.md) - [XAppCaptureVideoEncoding](/es/reference/system/xappcapture/enums/xappcapturevideoencoding.md)