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 |