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

# XClosedCaptionGetProperties

> XClosedCaptionGetProperties

# XClosedCaptionGetProperties

Devuelve las propiedades de los subtítulos ocultos actuales.

## Sintaxis

```cpp theme={null}
HRESULT XClosedCaptionGetProperties(  
         XClosedCaptionProperties* properties  
)  
```

### Parámetros

*properties*   \_Out\_\
Tipo: [XClosedCaptionProperties\*](/reference/system/xaccessibility/structs/xclosedcaptionproperties)

Cuando la función devuelve un resultado, *properties* contiene las propiedades actuales de los subtítulos ocultos.

### Valor devuelto

Tipo: HRESULT

HRESULT si los subtítulos ocultos están habilitados y *properties* contiene las [XClosedCaptionProperties](/reference/system/xaccessibility/structs/xclosedcaptionproperties) actuales. De lo contrario, devuelve un código de error.\
Para ver una lista de códigos de error, consulte [Códigos de error](/reference/errorcodes).

## Comentarios

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

Para que esta función se ejecute correctamente, los subtítulos ocultos deben estar habilitados.
El usuario debe habilitar la característica de subtítulos ocultos en la interfaz de usuario del título del juego.
Si el usuario habilitó los subtítulos ocultos, el título del juego puede marcar el estado de los subtítulos ocultos llamando a [XClosedCaptionSetEnabled](/reference/system/xaccessibility/functions/xclosedcaptionsetenabled).

En el ejemplo siguiente se muestra cómo devolver las propiedades de los subtítulos ocultos.

```cpp theme={null}
XClosedCaptionProperties ccProperties;
if (SUCCEEDED(XClosedCaptionGetProperties(&ccProperties))
{
    // The game title can now access color and font settings in the ccProperties structure.
}
```

## Requisitos

**Encabezado:** XAccessibility.h

**Biblioteca:** xgameruntime.lib

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

## Documentación conceptual

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

## Consulte también

[XAccessibility](/reference/system/xaccessibility/xaccessibility_members)

[XClosedCaptionProperties](/reference/system/xaccessibility/structs/xclosedcaptionproperties)

[XClosedCaptionSetEnabled](/reference/system/xaccessibility/functions/xclosedcaptionsetenabled)


## Related topics

- [XClosedCaptionProperties](/es/reference/system/xaccessibility/structs/xclosedcaptionproperties.md)
- [XClosedCaptionFontStyle](/es/reference/system/xaccessibility/enums/xclosedcaptionfontstyle.md)
- [XClosedCaptionFontEdgeAttribute](/es/reference/system/xaccessibility/enums/xclosedcaptionfontedgeattribute.md)
- [XClosedCaptionSetEnabled](/es/reference/system/xaccessibility/functions/xclosedcaptionsetenabled.md)
- [XAG 104: Subtítulos y subtítulos descriptivos](/es/build/game-principles/accessibility/xag-deep-dives/xag-104-subtitles-captions.md)