Funzione D3DKMTEnumAdapters3 (d3dkmthk.h)
Fornisce informazioni per l'enumerazione di schede grafiche e display 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 tutti gli adattatori. |
| 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. |
Osservazioni
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 enumererà comunque gli adattatori, ma sono presenti meno adattatori di D3DKMTEnumAdapters2 enumerati. Gli adattatori ComputeOnly vengono lasciati fuori dall'enumerazione predefinita, per evitare l'interruzione delle applicazioni. Anche gli adattatori DisplayOnly vengono lasciati fuori dall'enumerazione predefinita.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10, versione 2004 |
| piattaforma di destinazione | Finestre |
| intestazione |
d3dkmthk.h (include D3dkmthk.h) |
| libreria |
onecoreuap.lib |
| dll | Gdi32.dll |