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

# XtfCaptureScreenshot

> XtfCaptureScreenshot

# XtfCaptureScreenshot

Captura la pantalla actual de la consola de desarrollo especificada como mapa de bits.

<a id="syntaxSection" />

## Sintaxis

```cpp theme={null}
HRESULT XtfCaptureScreenshot(
         LPCWSTR address,
         HBITMAP* phBitmap
)  
```

<a id="parametersSection" />

### Parámetros

*address*   \
Tipo: LPCWSTR

Puntero a la dirección IP de herramientas o al nombre de host de la consola de desarrollo.

*phBitmap*   \
Tipo: HBITMAP\*

Puntero al HBITMAP del mapa de bits de la pantalla capturada, si se ejecuta correctamente. Cuando haya terminado de usar este mapa de bits, llame a `DeleteObject` para liberar los recursos asociados al HBITMAP.

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT.

<a id="remarksSection" />

## Comentarios

Esta función captura un mapa de bits de lo que se muestra actualmente en la pantalla de la consola de desarrollo especificada. El mapa de bits incluye todo lo que se muestra actualmente en la salida de la consola, incluidas las aplicaciones exclusivas, las aplicaciones compartidas, las aplicaciones acopladas, la interfaz de usuario del sistema, como Inicio o las notificaciones emergentes, etc. El mapa de bits usa la resolución de pantalla seleccionada actualmente para la consola.

El uso de **XtfCaptureScreenshot** toma el control momentáneo de la secuencia de salida de vídeo. Esto provoca un fallo momentáneo en la velocidad de fotogramas de la pantalla, y puede provocar un segmento de pantalla negra en el vídeo grabado por GameDVR en el momento de la captura.

El código debe seguir las prácticas de programación recomendadas y usar la información incrustada en el mapa de bits devuelto en `phBitmap` para determinar la resolución del mapa de bits resultante. La resolución prevista del mapa de bits resultante coincide con la resolución de pantalla actual de la consola de desarrollo.

Para obtener más información sobre cómo capturar una captura de pantalla, consulte [Herramienta de captura de pantalla (xbcapture.exe) (tema con NDA)](/tools/tools-console/commandlinetools/xbcapture).

<a id="requirementsSection" />

## Requisitos

**Encabezado:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

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

<a id="seealsoSection" />

## Consulte también

[XtfConsoleControl](/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)\
[Referencia de la API nativa de XBOX Tools Framework](/reference/tools/xtf/atoc-xtf-native)


## Related topics

- [XtfCaptureRecordedGameClip](/es/reference/tools/xtf/xtfapi/functions/xtfcapturegameclip-xbox-microsoft-m.md)
- [XAppCaptureScreenshotStream](/es/reference/system/xappcapture/structs/xappcapturescreenshotstream.md)
- [XAppCaptureTakeScreenshot](/es/reference/system/xappcapture/functions/xappcapturetakescreenshot.md)
- [XAppCaptureScreenshotFile](/es/reference/system/xappcapture/structs/xappcapturescreenshotfile.md)
- [XAppCaptureTakeDiagnosticScreenshot](/es/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md)