Condividi tramite

Funzione D3DKMTEnumAdapters2 (d3dkmthk.h)

  • Articolo

La funzione D3DKMTEnumAdapters2 fornisce informazioni per enumerare tutti gli adattatori grafici e display nel sistema.

Sintassi

NTSTATUS D3DKMTEnumAdapters2(
  const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);

Parametri

unnamedParam1

[in, out] Puntatore a una struttura D3DKMT_ENUMADAPTERS2 in cui fornire informazioni sugli adattatori nel sistema. Vedere la sezione Osservazioni.

Valore restituito

D3DKMTEnumAdapters2 restituisce STATUS_SUCCESS in caso di esito positivo o di errore, ad esempio uno dei seguenti.

Codice restituito Descrizione
STATUS_BUFFER_TOO_SMALL La matrice fornita è troppo piccola per ricevere tutti gli adattatori.
STATUS_INVALID_PARAMETER pAdapter è NULL oppure è un'area di memoria non valida.
STATUS_NO_MEMORY La memoria non può essere allocata per soddisfare l'operazione.

Osservazioni

In caso di input, NumAdapters specifica il numero di adattatori che possono essere restituiti nella matrice vuota a cui pAdapter punta. In caso di restituzione, se D3DKMT_ENUMADAPTERS2 restituisce STATUS_SUCCESS:

  • Se pAdapters è diverso da NULL, NumAdapters conterrà il numero di adattatori restituiti nella matrice pAdapters.
  • Se pAdapters è NULL, NumAdapters conterrà il numero massimo di adattatori supportato.

Se D3DKMT_ENUMADAPTERS2 restituisce un errore, NumAdapters non è definito.

D3DKMTEnumAdapters2 viene in genere chiamato due volte:

  • Per la prima chiamata, impostare pAdapters su NULL. D3DKMTEnumAdapters2 scriverà il numero massimo di adattatori supportato in NumAdapter.

  • Per la seconda chiamata, impostare NumAdapters sul valore restituito nella prima chiamata e impostare pAdapters in modo che punti a una matrice di strutture NumAdaptersD3DKMT_ENUMADAPTERS2. D3DKMTEnumAdapters2 compilerà la matrice e passerà indietro il numero di strutture di matrice (adattatori) riempite.

Dopo che il chiamante di D3DKMTEnumAdapters2 ha ricevuto correttamente un'enumerazione degli adattatori, è responsabilità del chiamante gestire la durata dell'adattatore D3DKMT_HANDLEs. Questi handle vengono restituiti tramite pAdaptere devono essere chiusi con D3DKMTCloseAdapter.

Fabbisogno

Requisito Valore
client minimo supportato Windows 8
server minimo supportato Windows Server 2012
piattaforma di destinazione Finestre
intestazione d3dkmthk.h (include D3dkmthk.h)
libreria Gdi32.lib
dll Gdi32.dll

Vedere anche

D3DKMT_ENUMADAPTERS2

PFND3DKMT_ENUMADAPTERS2

D3DKMTCloseAdapter