Метод IDXGIFactory2::RegisterOcclusionStatusEvent (dxgi1_2.h)

  • Статья

Регистрируется для получения уведомлений об изменениях в состоянии окклюзии с помощью сигнализации о событиях.

Синтаксис

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

Параметры

[in] hEvent

Дескриптор объекта события, который операционная система задает при уведомлении об изменении состояния окклюзии. Функция CreateEvent или OpenEvent возвращает этот дескриптор.

[out] pdwCookie

Указатель на значение ключа, которое приложение может передать в метод IDXGIFactory2::UnregisterOcclusionStatus для отмены регистрации события уведомления, заданного hEvent .

Возвращаемое значение

RegisterOcclusionStatusEvent возвращает:

  • S_OK, если метод успешно зарегистрировал событие.
  • E_OUTOFMEMORY, если память недоступна для завершения операции.
  • DXGI_ERROR_INVALID_CALL , является ли hEvent недопустимым дескриптором или дескриптором события.
  • Возможно, другие коды ошибок, описанные в DXGI_ERROR разделе.

Обновление платформы для Windows 7: В Windows 7 или Windows Server 2008 R2 с установленным обновлением платформы для Windows 7registerOcclusionStatusEvent завершается сбоем с E_NOTIMPL. Дополнительные сведения об Обновлении платформы для Windows 7 см. в разделе Обновление платформы для Windows 7.

Комментарии

Если вы вызываете RegisterOcclusionStatusEvent несколько раз с помощью одного и того же дескриптора событий, RegisterOcclusionStatusEvent завершается сбоем с DXGI_ERROR_INVALID_CALL.

Если вы вызываете RegisterOcclusionStatusEvent несколько раз с разными дескрипторами событий, RegisterOcclusionStatusEvent правильно регистрирует события.

Требования

   
Минимальная версия клиента Windows 8 и Обновление платформы для Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header dxgi1_2.h
Библиотека Dxgi.lib

См. также раздел

IDXGIFactory2