Funzione D3DKMTEnumAdapters2 (d3dkmthk.h)
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 matricepAdapters. - 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 |