IDXGIFactory2::RegisterOcclusionStatusWindow 메서드(dxgi1_2.h)

폐색 상태 변경에 대한 알림 메시지를 수신하도록 애플리케이션 창을 등록합니다.

구문

HRESULT RegisterOcclusionStatusWindow(
  [in]  HWND  WindowHandle,
  [in]  UINT  wMsg,
  [out] DWORD *pdwCookie
);

매개 변수

[in] WindowHandle

폐색 상태 변경이 발생할 때 알림 메시지를 보낼 창의 핸들입니다.

[in] wMsg

보낼 알림 메시지를 식별합니다.

[out] pdwCookie

애플리케이션이 IDXGIFactory2::UnregisterOcclusionStatus 메서드에 전달하여 wMsg 에서 지정하는 알림 메시지의 등록을 취소할 수 있는 키 값에 대한 포인터입니다.

반환 값

RegisterOcclusionStatusWindow는 다음을 반환합니다.

  • 창을 성공적으로 등록했는지 S_OK.
  • E_OUTOFMEMORY 메모리를 사용할 수 없는 경우 작업을 완료합니다.
  • WindowHandle이 유효한 창 핸들이 아니거나 현재 프로세스가 소유한 창 핸들이 아닌지 DXGI_ERROR_INVALID_CALL.
  • DXGI_ERROR 항목에 설명된 다른 오류 코드일 수 있습니다.

Windows 7용 플랫폼 업데이트: Windows 7 용 플랫폼 업데이트 가 설치된 Windows 7 또는 Windows Server 2008 R2에서 RegisterOcclusionStatusWindow 는 E_NOTIMPL 함께 실패합니다. Windows 7용 플랫폼 업데이트에 대한 자세한 내용은 Windows 7용 플랫폼 업데이트를 참조하세요.

설명

앱은 폐색 상태 변경 시 Windows에서 보내는 Windows 메시지를 선택합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 dxgi1_2.h
라이브러리 Dxgi.lib

추가 정보

IDXGIFactory2