Condividi tramite

Funzione D3DKMTEnumAdapters2 (d3dkmthk.h)

  • Articolo

La funzione D3DKMTEnumAdapters2 fornisce informazioni per enumerare tutte le schede grafiche e di visualizzazione 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 al termine dell'esito positivo o di un errore, ad esempio uno dei seguenti.

Codice restituito Descrizione
STATUS_BUFFER_TOO_SMALL La matrice fornita è troppo piccola per ricevere tutte le schede.
STATUS_INVALID_PARAMETER pAdapters è NULL o è in caso contrario un'area di memoria non valida.
STATUS_NO_MEMORY Impossibile allocare memoria per soddisfare l'operazione.

Commenti

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

  • Se pAdapters non è NULL, NumAdapters conterrà il numero di adapter restituiti nella matrice pAdapters .
  • Se pAdapters è NULL, NumAdapters conterrà il numero massimo di schede supportate.

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 schede supportate in NumAdapters.

  • Per la seconda chiamata, impostare NumAdapters sul valore restituito nella prima chiamata e impostare pAdapters per puntare a una matrice di strutture NumAdaptersD3DKMT_ENUMADAPTERS2 . D3DKMTEnumAdapters2 riempirà la matrice e passerà di nuovo il numero di strutture di matrice (adattatori) riempite.

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

Requisiti

Requisito Valore
Client minimo supportato Windows 8
Server minimo supportato Windows Server 2012
Piattaforma di destinazione Windows
Intestazione d3dkmthk.h (include D3dkmthk.h)
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche

D3DKMT_ENUMADAPTERS2

PFND3DKMT_ENUMADAPTERS2

D3DKMTCloseAdapter