XtfCaptureScreenshot
지정된 개발 콘솔의 현재 화면 표시를 비트맵으로 캡처합니다.
구문
HRESULT XtfCaptureScreenshot(
LPCWSTR address,
HBITMAP* phBitmap
)
매개 변수
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 콘솔 도구용)