D3DKMTEnumAdapters2-Funktion (d3dkmthk.h)
Die D3DKMTEnumAdapters2 Funktion liefert Informationen zum Aufzählen aller Grafik- und Anzeigeadapter auf dem System.
Syntax
NTSTATUS D3DKMTEnumAdapters2(
const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);
Parameter
unnamedParam1
[in, out] Zeiger auf eine D3DKMT_ENUMADAPTERS2 Struktur, in der Informationen zu Adaptern auf dem System bereitgestellt werden sollen. Siehe Anmerkungen.
Rückgabewert
D3DKMTEnumAdapters2 gibt STATUS_SUCCESS bei Erfolg oder einem Fehler wie einem der folgenden zurück.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_BUFFER_TOO_SMALL | Das bereitgestellte Array ist zu klein, um alle Adapter zu empfangen. |
| STATUS_INVALID_PARAMETER | pAdapters- 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
Bei eingaben gibt NumAdapters an, wie viele Adapter im leeren Array zurückgegeben werden können, auf das pAdapters verweist. Bei Rückgabe, wenn D3DKMT_ENUMADAPTERS2 STATUS_SUCCESS zurückgibt:
- Wenn pAdapters- ungleich NULL ist, enthält NumAdapters- die Anzahl der im pAdapters Array zurückgegebenen Adapter.
- Wenn pAdapters- NULL ist, enthält NumAdapters- die maximal unterstützte Adapteranzahl.
Wenn D3DKMT_ENUMADAPTERS2 einen Fehler zurückgibt, ist NumAdapters- nicht definiert.
D3DKMTEnumAdapters2 wird in der Regel zweimal aufgerufen:
Legen Sie für den ersten Aufruf pAdapters auf NULL fest. D3DKMTEnumAdapters2- schreibt die maximal unterstützte Adapteranzahl in NumAdapters-.
Legen Sie für den zweiten Aufruf NumAdapters auf den wert fest, der im ersten Aufruf zurückgegeben wird, und legen Sie pAdapters fest, auf ein Array von NumAdaptersD3DKMT_ENUMADAPTERS2 Strukturen verweisen. D3DKMTEnumAdapters2 füllt das Array aus und übergibt die Anzahl der von ihr ausgefüllten Arraystrukturen (Adapter).
Sobald der Aufrufer von D3DKMTEnumAdapters2 erfolgreich eine Aufzählung der Adapter erhalten hat, liegt es in der Verantwortung des Anrufers, die Lebensdauer des Adapters D3DKMT_HANDLEs zu verwalten. Diese Ziehpunkte werden über pAdapterszurückgegeben und müssen mit D3DKMTCloseAdaptergeschlossen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Fenster |
| Header- | d3dkmthk.h (einschließlich D3dkmthk.h) |
| Library | Gdi32.lib |
| DLL- | Gdi32.dll |