XtfCaptureScreenshot
지정된 개발 콘솔의 현재 화면 표시를 비트맵으로 캡처합니다.구문
매개 변수
address형식: LPCWSTR 개발 콘솔의 도구 IP 주소 또는 호스트 이름에 대한 포인터입니다. phBitmap
형식: HBITMAP* 성공한 경우 캡처된 화면 표시의 비트맵에 대한 HBITMAP 포인터입니다. 이 비트맵 사용을 마치면
DeleteObject를 호출하여 HBITMAP과 관련된 리소스를 해제합니다.
반환 값
형식: HRESULT 성공하면S_OK를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 함수는 지정된 개발 콘솔 화면에 현재 표시되는 내용의 비트맵을 캡처합니다. 비트맵에는 독점 앱, 공유 앱, 스냅된 앱, 홈 또는 알림 팝업과 같은 시스템 UI 등 콘솔 출력에 현재 표시되는 모든 것이 포함됩니다. 비트맵은 콘솔에서 현재 선택된 디스플레이 해상도를 사용합니다. XtfCaptureScreenshot을 사용하면 잠시 동안 비디오 출력 스트림을 제어합니다. 이로 인해 디스플레이에서 순간적인 프레임 속도 결함이 발생하고, 캡처 시점에 GameDVR로 녹화된 비디오에서 검은색 화면 구간이 발생할 수 있습니다. 코드는 권장 프로그래밍 관행을 따르고phBitmap에서 반환된 비트맵의 임베디드 정보를 사용하여 결과 비트맵의 해상도를 확인해야 합니다. 결과 비트맵의 예상 해상도는 개발 콘솔의 현재 화면 해상도와 일치합니다.
스크린샷 캡처에 대한 자세한 내용은 화면 캡처 도구(xbcapture.exe)(NDA 항목)를 참조하세요.
요구 사항
헤더: xtfconsolecontrol.h 라이브러리: xtfconsolecontrol.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)함께 보기
XtfConsoleControlXBOX Tools Framework 네이티브 API 참조