Metodo IDXGIFactory2::RegisterOcclusionStatusWindow (dxgi1_2.h)

  • Articolo

Registra una finestra dell'applicazione per ricevere messaggi di notifica delle modifiche dello stato di occlusione.

Sintassi

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

Parametri

[in] WindowHandle

Handle della finestra a cui inviare un messaggio di notifica quando si verifica una modifica dello stato di occlusione.

[in] wMsg

Identifica il messaggio di notifica da inviare.

[out] pdwCookie

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

Valore restituito

RegisterOcclusionStatusWindow restituisce:

  • S_OK se la finestra è stata registrata correttamente.
  • E_OUTOFMEMORY se la memoria non è disponibile per completare l'operazione.
  • DXGI_ERROR_INVALID_CALL se WindowHandle non è un handle di finestra valido o non l'handle della finestra di proprietà del processo corrente.
  • 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 , RegisterOcclusionStatusWindow ha esito negativo con E_NOTIMPL. Per altre info sull'aggiornamento della piattaforma per Windows 7, vedi Platform Update per Windows 7.

Commenti

Le app scelgono il messaggio di Windows inviato da Windows quando cambia lo stato di occlusione.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 e l'aggiornamento della piattaforma per Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2012 e l'aggiornamento della piattaforma per Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione dxgi1_2.h
Libreria Dxgi.lib

Vedi anche

IDXGIFactory2