Freigeben über


PFND3DKMT_ENUMADAPTERS3 Rückruffunktion (d3dkmthk.h)

Die PFND3DKMT_ENUMADAPTERS3 Rückruffunktion listet Grafiken und Grafikkarten im System auf.

Syntax

PFND3DKMT_ENUMADAPTERS3 Pfnd3dkmtEnumadapters3;

NTSTATUS Pfnd3dkmtEnumadapters3(
  [in/out] D3DKMT_ENUMADAPTERS3 *unnamedParam1
)
{...}

Parameter

[in/out] unnamedParam1

Eine D3DKMT_ENUMADAPTERS3-Struktur . Der Aufrufer übergibt die Arraygröße und einen leeren Arraybereich. Der Angerufene überprüft, ob genügend Platz im Array vorhanden ist, füllt das Array aus und gibt zurück, wie viel des Arrays verwendet wurde.

Rückgabewert

Diese Funktion gibt NTSTATUS zurück.

Code zurückgeben BESCHREIBUNG
STATUS_BUFFER_TOO_SMALL Das bereitgestellte Array ist zu klein, um alle Adapter zu empfangen.
STATUS_INVALID_PARAMETER Der pEnumAdapters-Member ist NULL oder ist andernfalls ein ungültiger Speicherbereich.
STATUS_NO_MEMORY Arbeitsspeicher kann nicht zugewiesen werden, um den Vorgang zu erfüllen.

Hinweise

Wenn D3DKMT_ENUMADAPTERS3::p Adapters NULL ist, wird D3DKMT_ENUMADAPTERS3::NumAdapters auf die maximale unterstützte Adapteranzahl festgelegt. Anrufer rufen in der Regel zuerst die -Methode auf, um die maximale unterstützte Adapteranzahl abzurufen.

Wenn der Angerufene Adapter erfolgreich aufzählt, wird er für die explizite Verwaltung der Lebensdauer des Adapters D3DKMT_HANDLEs verantwortlich. Diese Handles werden über pEnumAdapters an den Angerufenen zurückgegeben und müssen mit D3DKMTCloseAdapter geschlossen werden.

Wenn Sie keines der D3DKMT_ENUMADAPTERS3::Filterflags festlegen, werden die Adapter weiterhin aufgelistet, aber es gibt weniger Adapter als PFND3DKMT_ENUMADAPTERS2 Aufzählungen. ComputeOnly-Adapter werden nicht in der Standardaufzählung verwendet, um zu vermeiden, dass Anwendungen unterbrochen werden. DisplayOnly-Adapter werden auch nicht in der Standardaufzählung verwendet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 2004
Kopfzeile d3dkmthk.h

Weitere Informationen

D3DKMT_ENUMADAPTERS3

D3DKMTCloseAdapter

D3DKMTEnumAdapters3

PFND3DKMT_CLOSEADAPTER

PFND3DKMT_ENUMADAPTERS2