Metodo IDXGIFactory6::EnumAdapterByGpuPreference (dxgi1_6.h)

Articolo
02/26/2024

Enumera le schede grafiche in base a una determinata preferenza GPU.

Sintassi

HRESULT EnumAdapterByGpuPreference(
  [in]  UINT                Adapter,
  [in]  DXGI_GPU_PREFERENCE GpuPreference,
  [in]  REFIID              riid,
  [out] void                **ppvAdapter
);

Parametri

[in] Adapter

Tipo: UINT

Indice dell'adapter da enumerare. Gli indici sono in ordine di preferenza specificato in GpuPreference, ad esempio se viene specificato DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE , l'adattatore con prestazioni più elevate è in corrispondenza dell'indice 0, il secondo più alto è in corrispondenza dell'indice 1 e così via.

[in] GpuPreference

Tipo: DXGI_GPU_PREFERENCE

Preferenza GPU per l'app.

[in] riid

Tipo: REFIID

Identificatore univoco globale (GUID) dell'oggetto IDXGIAdapter a cui fa riferimento il parametro ppvAdapter .

[out] ppvAdapter

Tipo: void**

Indirizzo di un puntatore all'interfaccia IDXGIAdapter all'adattatore.

Questo parametro non deve essere NULL.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo; un codice di errore in caso contrario. Per un elenco dei codici di errore, vedere DXGI_ERROR.

Commenti

Questo metodo consente agli sviluppatori di selezionare la GPU che ritiene più appropriata per ogni dispositivo creato e usato dall'app.

Questo metodo è simile a IDXGIFactory1::EnumAdapters1, ma accetta una preferenza GPU per riordinare l'enumerazione dell'adapter. Restituisce l'IDXGIAdapter appropriato per la preferenza GPU specificata. È progettato per essere usato in combinazione con le funzioni D3DCreateDevice , che accettano un IDXGIAdapter.

Quando DXGI_GPU_PREFERENCE_UNSPECIFIED viene specificato per il parametro GpuPreference , questo metodo equivale a chiamare IDXGIFactory1::EnumAdapters1.

Quando DXGI_GPU_PREFERENCE_MINIMUM_POWER viene specificato per il parametro GpuPreference , l'ordine di preferenza per l'adattatore restituito in ppvAdapter sarà:

1. iGPU (GPU integrate)

2. dGPU (GPU discrete)

3. xGPU (GPU esterne)

Quando DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE viene specificato per il parametro GpuPreference , l'ordine di preferenza per l'adattatore restituito in ppvAdapter sarà:

1. xGPU

2. dGPU

3. iGPU

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1803 [solo app desktop]
Server minimo supportato	Windows Server, versione 1709 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dxgi1_6.h
Libreria	Dxgi.lib

Vedi anche

IDXGIFactory6

Esempio UWP xGPU

Esempio di desktop xGPU

Condividi tramite