Metodo IDirect3D9Ex::GetAdapterDisplayModeEx (d3d9.h)

Recupera le impostazioni correnti della modalità di visualizzazione e della rotazione dell'adattatore.

Sintassi

HRESULT GetAdapterDisplayModeEx(
  [in]      UINT               Adapter,
  [in, out] D3DDISPLAYMODEEX   *pMode,
  [in, out] D3DDISPLAYROTATION *pRotation
);

Parametri

[in] Adapter

Tipo: UINT

Numero ordinale che indica l'adattatore di visualizzazione per la query. D3DADAPTER_DEFAULT è sempre la scheda di visualizzazione primaria.

[in, out] pMode

Tipo: D3DDISPLAYMODEEX*

Puntatore a una struttura D3DDISPLAYMODEEX contenente dati sulla modalità di visualizzazione dell'adattatore. Anziché la modalità di visualizzazione del dispositivo, che potrebbe non essere attiva se il dispositivo non è in modalità schermo intero. Può essere impostato su NULL.

[in, out] pRotation

Tipo: D3DDISPLAYROTATION*

Puntatore a una struttura D3DDISPLAYROTATION che indica il tipo di rotazione dello schermo che l'applicazione eseguirà. Il valore restituito tramite questo puntatore è importante quando viene usato il flag di D3DPRESENTFLAG_NOAUTOROTATE ; in caso contrario, può essere impostato su NULL.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK.

Se Adapter non è compreso nell'intervallo o pMode non è valido, questo metodo restituisce D3DERR_INVALIDCALL.

Commenti

GetAdapterDisplayModeEx non restituisce il formato corretto quando la visualizzazione è in formato esteso, ad esempio 2:10:10:10. Restituisce invece il formato X8R8G8B8.

Per le applicazioni finestrate, un valore di S_PRESENT_MODE_CHANGED restituito da PresentEx o CheckDeviceState indica che la modalità di visualizzazione è stata modificata e che la modalità di visualizzazione corrente potrebbe avere un formato diverso. Per evitare una conversione dei colori, le applicazioni con finestra possono facoltativamente ottenere nuove informazioni sulla modalità di visualizzazione usando questo metodo e modificando di conseguenza il formato della catena di scambio. Questo metodo restituisce D3DERR_NOTAVAILABLE se questa testa non fa più parte del desktop o se il monitoraggio è disconnesso.

Requisiti

Vedi anche

IDirect3D9Ex