DXGKDDI_QUERYADAPTERINFO Rückruffunktion (d3dkmddi.h)
Dxgkrnl- ruft die KMD -DxgkDdiQueryAdapterInfo-Funktion auf, um Konfigurationsinformationen aus dem Grafikadapter abzurufen.
Syntax
DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;
NTSTATUS DxgkddiQueryadapterinfo(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}
Parameter
[in] hAdapter
Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der KMD hat dieses Handle zuvor für Dxgkrnl- im MiniportDeviceContext Ausgabeparameter der DxgkDdiAddDevice--Funktion bereitgestellt.
[in] pQueryAdapterInfo
Ein Zeiger auf eine DXGKARG_QUERYADAPTERINFO Struktur, die der KMD mit den Konfigurationsinformationen für den Grafikadapter ausfüllt.
Rückgabewert
DxgkDdiQueryAdapterInfo gibt STATUS_SUCCESS zurück, wenn die Konfigurationsinformationen erfolgreich abgerufen wurden. Andernfalls wird ein NTSTATUS-Code zurückgegeben, z. B. einen der folgenden Werte:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Mindestens ein übergebener Parameter enthielt Fehler, die das Abschließen verhinderten. |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo- konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | Der KMD ist nicht mit dem Benutzermodusanzeigetreiber (USER-Mode Display Driver, UMD) kompatibel, der den Aufruf von DxgkDdiQueryAdapterInfo initiiert hat (d. h., private Daten für eine Abfrage an die KMD bereitgestellt). |
Bemerkungen
Wenn die UMD die pfnQueryAdapterInfoCb Callback der Direct3D-Laufzeit aufruft, wird ein Aufruf der DxgkDdiQueryAdapterInfo-Funktion initiiert.
Wenn Dxgkrnl- DXGKQAITYPE_UMDRIVERPRIVATE in DXGKARG_QUERYADAPTERINFO::Typeangibt, verweist pOutputData- auf eine proprietäre Struktur, die KMD mit den Konfigurationsinformationen ausfüllt, die erforderlich sind, um den Adapter zu identifizieren.
Wenn Dxgkrnl- DXGKQAITYPE_DRIVERCAPS in DXGKARG_QUERYADAPTERINFO::Typeangibt, sollte die KMD die bereitgestellte DXGK_DRIVERCAPS Struktur mit Informationen auffüllen, die das Subsystem verwenden kann.
Wenn Dxgkrnl- DXGKQAITYPE_QUERYSEGMENT in DXGKARG_QUERYADAPTERINFO::Typeangibt, sollte die KMD Informationen zu den unterstützten Speichersegmenten bereitstellen. Weitere Informationen zu Speichersegmenten finden Sie unter Initialisierung der Verwendung von Speichersegmenten.
DxgkDdiQueryAdapterInfo sollte seitenfähig gemacht werden.
Alle Treiber, die WDDM 2.6 und höher unterstützen, müssen die DxgkDdiQueryAdapterInfo Rückruf implementieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista (WDDM 1.0) |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h |
| IRQL- | PASSIVE_LEVEL |