XtfCaptureScreenshot
Captura la pantalla actual de la consola de desarrollo especificada como mapa de bits.Sintaxis
Parámetros
addressTipo: 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.
Valor devuelto
Tipo: HRESULT DevuelveS_OK si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT.
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 enphBitmap 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).
Requisitos
Encabezado: xtfconsolecontrol.h Biblioteca: xtfconsolecontrol.lib Plataformas compatibles: Windows (para las herramientas de consola XBOX)Consulte también
XtfConsoleControlReferencia de la API nativa de XBOX Tools Framework