D3DKMTEnumAdapters3-Funktion (d3dkmthk.h)
Stellt Informationen zum Aufzählen von Grafiken und Grafikkarten auf dem System bereit.
Syntax
NTSTATUS D3DKMTEnumAdapters3(
[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, das Array ausfüllt und zurückgibt, wie viel array verwendet wurde.
Rückgabewert
Diese Funktion gibt NTSTATUS zurück.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_BUFFER_TOO_SMALL | Das bereitgestellte Array ist zu klein, um alle Adapter zu empfangen. |
| STATUS_INVALID_PARAMETER | Das Element "pEnumAdapters" ist NULL oder ist andernfalls ein ungültiger Speicherbereich. |
| STATUS_NO_MEMORY | Der Arbeitsspeicher kann nicht zugewiesen werden, um den Vorgang zu erfüllen. |
Bemerkungen
Wenn D3DKMT_ENUMADAPTERS3::p Adapters null ist, wird D3DKMT_ENUMADAPTERS3::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.
Wenn Sie keines der D3DKMT_ENUMADAPTERS3::Filter-Flags festlegen, werden weiterhin Adapter aufgezählt, aber es gibt weniger Adapter als D3DKMTEnumAdapters2 Aufzählungen. ComputeOnly-Adapter werden von der Standardenumeration weggelassen, um zu vermeiden, dass Anwendungen unterbrochen werden. DisplayOnly-Adapter werden auch von der Standardenumeration entfernt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 2004 |
| Zielplattform- | Fenster |
| Header- | d3dkmthk.h (einschließlich D3dkmthk.h) |
| Library | onecoreuap.lib |
| DLL- | Gdi32.dll |