Metodo IDirect3D9::EnumAdapterModes (d3d9helper.h)

Articolo
08/23/2023

Esegue una query sul dispositivo per determinare se l'adattatore specificato supporta il formato e la modalità di visualizzazione richiesti. Questo metodo può essere usato in un ciclo per enumerare tutte le modalità di adattatore disponibili.

Sintassi

HRESULT EnumAdapterModes(
  [in]  UINT           Adapter,
  [in]  D3DFORMAT      Format,
  [in]  UINT           Mode,
  [out] D3DDISPLAYMODE *pMode
);

Parametri

[in] Adapter

Tipo: UINT

Numero ordinale che indica l'adattatore di visualizzazione da enumerare. D3DADAPTER_DEFAULT è sempre la scheda di visualizzazione primaria. Questo metodo restituisce D3DERR_INVALIDCALL quando questo valore è uguale o supera il numero di schede di visualizzazione nel sistema.

[in] Format

Tipo: D3DFORMAT

Formati pixel consentiti. Vedere la sezione Osservazioni.

[in] Mode

Tipo: UINT

Rappresenta l'indice in modalità visualizzazione che è un intero senza segno compreso tra zero e il valore restituito da GetAdapterModeCount meno uno.

[out] pMode

Tipo: D3DDISPLAYMODE*

Puntatore alla modalità di visualizzazione disponibile di tipo D3DDISPLAYMODE. Vedere la sezione Osservazioni.

Valore restituito

Tipo: HRESULT

Se il dispositivo può essere usato in questa scheda, viene restituito D3D_OK.
Se l'adattatore è uguale o supera il numero di schede di visualizzazione nel sistema, viene restituito D3DERR_INVALIDCALL.
Se il formato della superficie non è supportato o se l'accelerazione hardware non è disponibile per i formati specificati, viene restituito D3DERR_NOTAVAILABLE.

Commenti

Un'applicazione fornisce una modalità di visualizzazione e un formato a EnumAdapterModes che restituisce una modalità di visualizzazione. Questo metodo può essere usato in un ciclo per enumerare tutte le modalità di visualizzazione disponibili.

L'applicazione specifica un formato e l'enumerazione è limitata a quelle modalità di visualizzazione che corrispondono esattamente al formato (alfa viene ignorato). I formati consentiti (che sono membri di D3DFORMAT) sono i seguenti:

D3DFMT_A1R5G5B5
D3DFMT_A2R10G10B10
D3DFMT_A8R8G8B8
D3DFMT_R5G6B5
D3DFMT_X1R5G5B5
D3DFMT_X8R8G8B8

Inoltre, EnumAdapterModes considera i formati di pixel 565 e 555 come equivalenti e restituisce la versione corretta. La differenza entra in gioco solo quando l'applicazione blocca il buffer nascosto e c'è un flag esplicito che l'applicazione deve impostare per eseguire questa operazione.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	d3d9helper.h (include D3D9.h)
Libreria	D3D9.lib

Vedi anche

IDirect3D9

Condividi tramite