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

# XAppCaptureRecordDiagnosticClip

> XAppCaptureRecordDiagnosticClip

# XAppCaptureRecordDiagnosticClip

Graba un clip de diagnóstico desde la aplicación.

## Sintaxis

```cpp theme={null}
HRESULT XAppCaptureRecordDiagnosticClip(  
         time_t startTime,  
         uint32_t durationInMs,  
         const char* filenamePrefix,  
         XAppCaptureRecordClipResult* result  
)  
```

### Parámetros

*startTime*   \_In\_\
Tipo: time\_t

Marca de tiempo del comienzo del clip de diagnóstico.

*durationInMs*   \_In\_\
Tipo: uint32\_t

Duración en milisegundos del clip de diagnóstico.

*filenamePrefix*   \_In\_opt\_\
Tipo: char\*

Prefijo deseado para el nombre de archivo; es opcional y se anexará al principio del nombre del archivo de diagnóstico.

*result*   \_Out\_\
Tipo: [XAppCaptureRecordClipResult\*](/reference/system/xappcapture/structs/xappcapturerecordclipresult)

Clip de diagnóstico grabado resultante.

### Valor devuelto

Tipo: HRESULT

Resultado de la función.

## Comentarios

<Note>No es seguro llamar a esta función en un subproceso con restricciones de tiempo. Para obtener más información, consulte [Subprocesos con restricciones de tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Llamar a esta función no desencadena una notificación de interfaz de usuario. Los clips se guardan en una partición accesible para el juego. [XAppCaptureRecordDiagnosticClipResult](/reference/system/xappcapture/structs/xappcapturerecordclipresult) contiene una ruta de acceso de archivo que puede usar para acceder al clip.
En XBOX, esta función solo estará disponible en kits de desarrollo. En kits comerciales, esta API devolverá un error inmediatamente.

En PC, debe habilitar la grabación en segundo plano para la aplicación a fin de que esta función funcione. La mejor manera de hacerlo es abrir Game Bar presionando Win+G, luego hacer clic en el icono de configuración, ir a la pestaña de captura y habilitar "Record in the background while I'm playing a game".
Después, debe marcar la aplicación como juego. La mejor manera de hacerlo es ejecutar primero el juego. Mientras el juego tiene el foco, abra Game Bar presionando Win+G, haga clic en el icono de configuración, vaya a la pestaña general y active "Remember this is a game".

## Requisitos

**Encabezado:** XAppCapture.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Subprocesos con restricciones de tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Consulte también

[Información general de GameDVR](/build/console-features/game-dvr/gamedvr-broadcast)\
[Miembros de XAppCapture](/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureRecordDiagnosticClipResult](/reference/system/xappcapture/structs/xappcapturerecordclipresult)


## Related topics

- [XAppCaptureRecordClipResult](/es/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)
- [XAppCapture](/es/reference/system/xappcapture/xappcapture_members.md)
- [Contenedores de API de C# de Unity para el GDK](/es/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XAppCaptureStartUserRecord](/es/reference/system/xappcapture/functions/xappcapturestartuserrecord.md)
- [XAppCaptureRecordTimespan](/es/reference/system/xappcapture/functions/xappcapturerecordtimespan.md)