DXGKDDI_QUERYADAPTERINFO Rückruffunktion (d3dkmddi.h)
Die DxgkDdiQueryAdapterInfo-Funktion des Anzeigeminiports (KMD) ruft Konfigurationsinformationen vom Grafikkarten ab.
Syntax
DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;
NTSTATUS DxgkddiQueryadapterinfo(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}
Parameter
[in] hAdapter
Ein Handle für einen Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die KMD hat dieses Handle zuvor für Dxgkrnl im Ausgabeparameter MiniportDeviceContext der DxgkDdiAddDevice-Funktion bereitgestellt.
[in] pQueryAdapterInfo
Ein Zeiger auf eine DXGKARG_QUERYADAPTERINFO Struktur, die der KMD mit den Konfigurationsinformationen für den Grafikkarten füllt.
Rückgabewert
DxgkDdiQueryAdapterInfo gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | DxgkDdiQueryAdapterInfo hat die Konfigurationsinformationen erfolgreich abgerufen. |
| STATUS_INVALID_PARAMETER | Parameter, die an DxgkDdiQueryAdapterInfo übergeben wurden, enthielten Fehler, die den Abschluss verhinderten. |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo konnte keinen Speicher zuordnen, der für die Vervollständigung erforderlich war. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | Der Anzeigeminiporttreiber ist nicht kompatibel mit dem Benutzermodus-Anzeigetreiber, der den Aufruf von DxgkDdiQueryAdapterInfo initiiert hat (d. h. die bereitgestellten privaten Daten für eine Abfrage an den Anzeigeminiporttreiber). |
Hinweise
Wenn der Benutzermodusanzeigetreiber die PfnQueryAdapterInfoCb-Funktion aufruft , wird ein Aufruf der DxgkDdiQueryAdapterInfo-Funktion initiiert.
Wenn DxgkDdiQueryAdapterInfo den DXGKQAITYPE_UMDRIVERPRIVATE Wert im Type-Member der DXGKARG_QUERYADAPTERINFO-Struktur empfängt, auf die der pQueryAdapterInfo-Parameter verweist, verweist pOutputData auf eine proprietäre Struktur, die KMD mit den Konfigurationsinformationen füllt, die für den Benutzermodusanzeigetreiber zum Identifizieren des Adapters erforderlich sind.
Wenn Dxgkrnl den DXGKQAITYPE_DRIVERCAPS-Wert im Type-Member von DXGKARG_QUERYADAPTERINFO angibt, wenn das Subsystem DxgkDdiQueryAdapterInfo aufruft, sollte der Anzeigeminiporttreiber die angegebene DXGK_DRIVERCAPS-Struktur mit Informationen auffüllen, die das Subsystem verwenden kann.
Wenn das DirectX-Grafikkernsubsystem den DXGKQAITYPE_QUERYSEGMENT-Wert im Type-Member von DXGKARG_QUERYADAPTERINFO bereitstellt, sollte der Anzeigeminiporttreiber Informationen zu den unterstützten Speichersegmenten bereitstellen. Weitere Informationen zu Speichersegmenten finden Sie unter Initializing Use of Memory Segment.
DxgkDdiQueryAdapterInfo sollte ausgelagert werden.
Alle Treiber, die WDDM 2.6 und höher unterstützen, müssen den DxgkDdiQueryAdapterInfo-Rückruf implementieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |