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

  • Article

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