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

지정된 개발 콘솔의 현재 화면 표시를 비트맵으로 캡처합니다.

<a id="syntaxSection" />

## 구문

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

<a id="parametersSection" />

### 매개 변수

*address*   \
형식: LPCWSTR

개발 콘솔의 도구 IP 주소 또는 호스트 이름에 대한 포인터입니다.

*phBitmap*   \
형식: HBITMAP\*

성공한 경우 캡처된 화면 표시의 비트맵에 대한 HBITMAP 포인터입니다. 이 비트맵 사용을 마치면 `DeleteObject`를 호출하여 HBITMAP과 관련된 리소스를 해제합니다.

<a id="retvalSection" />

### 반환 값

형식: HRESULT

성공하면 `S_OK`를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

<a id="remarksSection" />

## 설명

이 함수는 지정된 개발 콘솔 화면에 현재 표시되는 내용의 비트맵을 캡처합니다. 비트맵에는 독점 앱, 공유 앱, 스냅된 앱, 홈 또는 알림 팝업과 같은 시스템 UI 등 콘솔 출력에 현재 표시되는 모든 것이 포함됩니다. 비트맵은 콘솔에서 현재 선택된 디스플레이 해상도를 사용합니다.

**XtfCaptureScreenshot**을 사용하면 잠시 동안 비디오 출력 스트림을 제어합니다. 이로 인해 디스플레이에서 순간적인 프레임 속도 결함이 발생하고, 캡처 시점에 GameDVR로 녹화된 비디오에서 검은색 화면 구간이 발생할 수 있습니다.

코드는 권장 프로그래밍 관행을 따르고 `phBitmap`에서 반환된 비트맵의 임베디드 정보를 사용하여 결과 비트맵의 해상도를 확인해야 합니다. 결과 비트맵의 예상 해상도는 개발 콘솔의 현재 화면 해상도와 일치합니다.

스크린샷 캡처에 대한 자세한 내용은 [화면 캡처 도구(xbcapture.exe)(NDA 항목)](/tools/tools-console/commandlinetools/xbcapture)를 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** xtfconsolecontrol.h

**라이브러리:** xtfconsolecontrol.lib

**지원 플랫폼:** Windows(XBOX 콘솔 도구용)

<a id="seealsoSection" />

## 함께 보기

[XtfConsoleControl](/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)\
[XBOX Tools Framework 네이티브 API 참조](/reference/tools/xtf/atoc-xtf-native)


## Related topics

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