Поделиться через


Метод 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, если память недоступна для завершения операции.
  • DXGI_ERROR_INVALID_CALL , является ли WindowHandle недопустимым дескриптором окна или не является дескриптором окна, принадлежащим текущему процессу.
  • Возможно, другие коды ошибок, описанные в разделе DXGI_ERROR .

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

Комментарии

Приложения выбирают сообщение Windows, которое Windows отправляет при изменении состояния окклюзии.

Требования

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

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

IDXGIFactory2