Freigeben über

PFND3DKMT_ENUMADAPTERS2 Rückruffunktion (d3dkmthk.h)

  • Artikel

Die PFND3DKMT_ENUMADAPTERS2 Rückruffunktion listet alle Grafik- und Anzeigeadapter auf dem System auf.

Syntax

PFND3DKMT_ENUMADAPTERS2 Pfnd3dkmtEnumadapters2;

NTSTATUS Pfnd3dkmtEnumadapters2(
  const D3DKMT_ENUMADAPTERS2 *unnamedParam1
)
{...}

Parameter

unnamedParam1

_Inout_D3DKMT_ENUMADAPTERS2 * Arg1

Der Aufrufer übergibt die Arraygröße und den leeren Arraybereich. Der Angerufene überprüft genügend Raum im Array, füllt Array aus und gibt zurück, wie viel der Array verwendet wurde.

Rückgabewert

Diese Funktion gibt NTSTATUS zurück.

Rückgabecode Beschreibung
STATUS_BUFFER_TOO_SMALL Wenn das bereitgestellte Array zu klein ist, um alle Adapter zu empfangen.
STATUS_INVALID_PARAMETER Wenn pEnumAdapters null ist oder andernfalls ein ungültiger Speicherbereich ist.
STATUS_NO_MEMORY Wenn der Arbeitsspeicher nicht zugewiesen werden kann, um den Vorgang zu erfüllen.

Bemerkungen

Wenn D3DKMT_ENUMADAPTERS2::p Adapters null ist, wird D3DKMT_ENUMADAPTERS2::NumAdapters auf die maximal unterstützte Adapteranzahl festgelegt. Angerufene rufen die Methode häufig zuerst auf, um die maximal 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 Ziehpunkte werden über pEnumAdapters an den Angerufenen zurückgegeben und müssen mit D3DKMTCloseAdaptergeschlossen werden.

Anforderungen

Anforderung Wert
Header- d3dkmthk.h

Siehe auch