Méthode IDXGIFactory2::RegisterOcclusionStatusEvent (dxgi1_2.h)

Article
08/23/2023

S’inscrit pour recevoir une notification des modifications apportées à l’occlusion status à l’aide de la signalisation d’événements.

Syntaxe

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

Paramètres

[in] hEvent

Handle de l’objet d’événement que le système d’exploitation définit quand une notification d’occlusion status modification se produit. La fonction CreateEvent ou OpenEvent retourne ce handle.

[out] pdwCookie

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

Valeur retournée

RegisterOcclusionStatusEvent retourne :

S_OK si la méthode a correctement inscrit l’événement.
E_OUTOFMEMORY si la mémoire n’est pas disponible pour terminer l’opération.
DXGI_ERROR_INVALID_CALL si hEvent n’est pas un handle valide ou pas un handle d’événement.
É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, RegisterOcclusionStatusEvent é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.

Notes

Si vous appelez RegisterOcclusionStatusEvent plusieurs fois avec le même handle d’événement, RegisterOcclusionStatusEvent échoue avec DXGI_ERROR_INVALID_CALL.

Si vous appelez RegisterOcclusionStatusEvent plusieurs fois avec les différents descripteurs d’événements, RegisterOcclusionStatusEvent inscrit correctement les événements.

Spécifications


Client minimal pris en charge	Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et Platform Update pour Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dxgi1_2.h
Bibliothèque	Dxgi.lib

Voir aussi

IDXGIFactory2

Partager via