IdXGIFactory2 ::RegisterOcclusionStatusWindow, méthode (dxgi1_2.h)

Inscrit une fenêtre d’application pour recevoir des messages de notification de modifications d’occlusion status.

Syntaxe

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

Paramètres

[in] WindowHandle

Handle de la fenêtre à laquelle envoyer un message de notification lorsque l’occlusion status modification se produit.

[in] wMsg

Identifie le message de notification à envoyer.

[out] pdwCookie

Pointeur vers une valeur de clé qu’une application peut passer à la méthode IDXGIFactory2 ::UnregisterOcclusionStatus pour annuler l’inscription du message de notification spécifié par wMsg .

Valeur retournée

RegisterOcclusionStatusWindow retourne :

  • S_OK s’il a correctement inscrit la fenêtre.
  • E_OUTOFMEMORY si la mémoire n’est pas disponible pour terminer l’opération.
  • DXGI_ERROR_INVALID_CALL si WindowHandle n’est pas un handle de fenêtre valide ou pas le handle de fenêtre dont le processus actuel est propriétaire.
  • Éventuellement d’autres codes d’erreur décrits dans la rubrique DXGI_ERROR .

Mise à jour de plateforme pour Windows 7 : Sur Windows 7 ou Windows Server 2008 R2 avec la mise à jour de plateforme pour Windows 7 installée, RegisterOcclusionStatusWindow échoue avec E_NOTIMPL. Pour plus d’informations sur la mise à jour de plateforme pour Windows 7, consultez Mise à jour de plateforme pour Windows 7.

Remarques

Les applications choisissent le message Windows que Windows envoie lorsque l’occlusion status change.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête dxgi1_2.h
Bibliothèque Dxgi.lib

Voir aussi

IDXGIFactory2