Condividi tramite

Funzione D3DKMTEnumAdapters3 (d3dkmthk.h)

  • Articolo

Fornisce informazioni per l'enumerazione di schede grafiche e di visualizzazione nel sistema.

Sintassi

NTSTATUS D3DKMTEnumAdapters3(
  [in/out] D3DKMT_ENUMADAPTERS3 *unnamedParam1
);

Parametri

[in/out] unnamedParam1

Struttura D3DKMT_ENUMADAPTERS3 . Il chiamante passa le dimensioni della matrice e uno spazio di matrice vuoto. Il chiamato verifica che nella matrice sia presente spazio sufficiente, riempia la matrice e restituisce la quantità di matrice usata.

Valore restituito

Questa funzione restituisce NTSTATUS.

Codice restituito Descrizione
STATUS_BUFFER_TOO_SMALL La matrice fornita è troppo piccola per ricevere tutte le schede.
STATUS_INVALID_PARAMETER Il membro pEnumAdapters è Null o è in caso contrario un'area di memoria non valida.
STATUS_NO_MEMORY La memoria non può essere allocata per soddisfare l'operazione.

Commenti

Quando D3DKMT_ENUMADAPTERS3::p Adapters è Null, D3DKMT_ENUMADAPTERS3::NumAdapters viene impostato sul numero massimo di adattatori supportati. I chiamato richiamano in genere il metodo , prima di tutto, per recuperare il numero massimo di adattatori supportati.

Quando il chiamato enumera correttamente gli adapter, diventa responsabile della gestione esplicita della durata dell'adattatore D3DKMT_HANDLEs. Questi handle vengono restituiti al chiamato tramite pEnumAdapter e devono essere chiusi con D3DKMTCloseAdapter.

L'impostazione di nessuno dei flag D3DKMT_ENUMADAPTERS3::Filter enumera ancora gli adattatori, ma sono presenti meno adattatori rispetto alle enumerazioni D3DKMTEnumAdapters2 . Le schede computeOnly vengono lasciate fuori dall'enumerazione predefinita, per evitare l'interruzione delle applicazioni. Anche gli adattatori DisplayOnly vengono lasciati dall'enumerazione predefinita.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 2004
Piattaforma di destinazione Windows
Intestazione d3dkmthk.h (include D3dkmthk.h)
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche

D3DKMT_ENUMADAPTERS3

D3DKMTCloseAdapter

PFND3DKMT_ENUMADAPTERS3

D3DKMTCloseAdapter