PFND3DKMT_ENUMADAPTERS3 Rückruffunktion (d3dkmthk.h)

Artikel
02/23/2024

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.