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 |