PFND3DKMT_ENUMADAPTERS3 funzione di callback (d3dkmthk.h)

Articolo
08/07/2023

La funzione di callback PFND3DKMT_ENUMADAPTERS3 enumera schede grafiche e di visualizzazione nel sistema.

Sintassi

PFND3DKMT_ENUMADAPTERS3 Pfnd3dkmtEnumadapters3;

NTSTATUS Pfnd3dkmtEnumadapters3(
  [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 chiamante verifica che nella matrice sia presente spazio sufficiente, riempie la matrice e passa di nuovo 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	Impossibile allocare memoria per soddisfare l'operazione.

Commenti

Quando D3DKMT_ENUMADAPTERS3::p Adapters è Null, D3DKMT_ENUMADAPTERS3::NumAdapters è impostato sul numero massimo di schede supportate. Le chiamate richiamano in genere il metodo, prima di tutto, per recuperare il numero massimo di adattatori supportati.

Quando il chiamante enumera correttamente gli adattatori, diventa responsabile della gestione esplicita della durata dell'adattatore D3DKMT_HANDLEs. Questi handle vengono restituiti alla chiamata tramite pEnumAdapters e devono essere chiusi con D3DKMTCloseAdapter.

L'impostazione di nessuno dei flag di D3DKMT_ENUMADAPTERS3::Filter enumera comunque gli adattatori, ma sono presenti meno adattatori rispetto a PFND3DKMT_ENUMADAPTERS2 enumerazioni. Le schede di calcoloOnly non sono incluse nell'enumerazione predefinita, per evitare l'interruzione delle applicazioni. Gli adattatori DisplayOnly vengono inoltre lasciati fuori dall'enumerazione predefinita.