Share via

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

  • 아티클

이벤트 신호를 사용하여 폐색 상태 변경 내용에 대한 알림을 수신하도록 등록합니다.

구문

HRESULT RegisterOcclusionStatusEvent(
  [in]  HANDLE hEvent,
  [out] DWORD  *pdwCookie
);

매개 변수

[in] hEvent

폐색 상태 변경 알림이 발생할 때 운영 체제에서 설정하는 이벤트 개체에 대한 핸들입니다. CreateEvent 또는 OpenEvent 함수는 이 핸들을 반환합니다.

[out] pdwCookie

hEvent가 지정하는 알림 이벤트를 등록 취소하기 위해 애플리케이션이 IDXGIFactory2::UnregisterOcclusionStatus 메서드에 전달할 수 있는 키 값에 대한 포인터입니다.

반환 값

RegisterOcclusionStatusEvent는 다음을 반환합니다.

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

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

설명

동일한 이벤트 핸들을 사용하여 RegisterOcclusionStatusEvent를 여러 번 호출하면 DXGI_ERROR_INVALID_CALL RegisterOcclusionStatusEvent가 실패합니다.

다른 이벤트 핸들 을 사용하여 RegisterOcclusionStatusEvent 를 여러 번 호출하면 RegisterOcclusionStatusEvent 가 이벤트를 올바르게 등록합니다.

요구 사항

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

추가 정보

IDXGIFactory2