Metodo IDXGIFactory2::RegisterOcclusionStatusEvent (dxgi1_2.h)

Esegue la registrazione per ricevere una notifica delle modifiche nello stato di occlusione usando la segnalazione degli eventi.

Sintassi

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

Parametri

[in] hEvent

Handle per l'oggetto evento impostato dal sistema operativo quando si verifica la notifica della modifica dello stato di occlusione. La funzione CreateEvent o OpenEvent restituisce questo handle.

[out] pdwCookie

Puntatore a un valore di chiave che un'applicazione può passare al metodo IDXGIFactory2::UnregisterOcclusionStatus per annullare la registrazione dell'evento di notifica specificato da hEvent .

Valore restituito

RegisterOcclusionStatusEvent restituisce :

• S_OK se il metodo ha registrato correttamente l'evento.
• E_OUTOFMEMORY se la memoria non è disponibile per completare l'operazione.
• DXGI_ERROR_INVALID_CALL se hEvent non è un handle valido o non un handle eventi.
• Possibilmente altri codici di errore descritti nell'argomento DXGI_ERROR .

Aggiornamento della piattaforma per Windows 7: In Windows 7 o Windows Server 2008 R2 con l'aggiornamento della piattaforma per Windows 7 installato , RegisterOcclusionStatusEvent ha esito negativo con E_NOTIMPL. Per altre info sull'aggiornamento della piattaforma per Windows 7, vedi Platform Update per Windows 7.

Commenti

Se si chiama RegisterOcclusionStatusEvent più volte con lo stesso handle di evento, RegisterOcclusionStatusEvent ha esito negativo con DXGI_ERROR_INVALID_CALL.

Se si chiama RegisterOcclusionStatusEvent più volte con i diversi handle di evento, RegisterOcclusionStatusEvent registra correttamente gli eventi.

Requisiti

Vedi anche

IDXGIFactory2