DXGKDDI_QUERYADAPTERINFO回呼函式 (d3dkmddi.h)
顯示迷你埠的 (KMD) DxgkDdiQueryAdapterInfo 函式會從圖形適配卡擷取組態資訊。
語法
DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;
NTSTATUS DxgkddiQueryadapterinfo(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}
參數
[in] hAdapter
與顯示配接器相關聯的內容區塊句柄。 KMD 先前在 DxgkDdiAddDevice 函式的 MiniportDeviceContext 輸出參數中，將此句柄提供給 Dxgkrnl。
[in] pQueryAdapterInfo
DXGKARG_QUERYADAPTERINFO 結構的指標 ，KMD 會填入圖形適配卡的組態資訊。
傳回值
DxgkDdiQueryAdapterInfo 會傳回下列其中一個值：
| 傳回碼 | Description |
|---|---|
| STATUS_SUCCESS | DxgkDdiQueryAdapterInfo 已成功擷取設定資訊。 |
| STATUS_INVALID_PARAMETER | 傳遞至 DxgkDdiQueryAdapterInfo 的參數包含導致無法完成的錯誤。 |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo 無法配置完成所需的記憶體。 |
| STATUS_GRAPHICS_DRIVER_MISMATCH | 顯示迷你埠驅動程式與起始對 DxgkDdiQueryAdapterInfo 呼叫的使用者模式顯示驅動程式不相容， (亦即，為顯示迷你埠驅動程式) 提供查詢的私人數據。 |
備註
當使用者模式顯示驅動程式呼叫 pfnQueryAdapterInfoCb 函式時，會起始 DxgkDdiQueryAdapterInfo 函式的呼叫。
如果 DxgkDdiQueryAdapterInfo 收到 pQueryAdapterInfo 參數所指向之DXGKARG_QUERYADAPTERINFO結構的 Type 成員中的DXGKQAITYPE_UMDRIVERPRIVATE值，pOutputData 會指向 KMD 填入使用者模式顯示驅動程序識別配接器所需的組態資訊專屬結構。
如果 Dxgkrnl 指定當子系統呼叫 DxgkDdiQueryAdapterInfo 時，DXGKARG_QUERYADAPTERINFO Type 成員中的DXGKQAITYPE_DRIVERCAPS值，則顯示迷你埠驅動程式應該會在提供的DXGK_DRIVERCAPS結構中填入子系統可以使用的資訊。
如果 DirectX 圖形核心子系統在 DXGKARG_QUERYADAPTERINFO 的 Type 成員中提供DXGKQAITYPE_QUERYSEGMENT值，則顯示迷你埠驅動程式應該提供其支援的記憶體區段相關信息。 如需記憶體區段的詳細資訊，請參閱 初始化記憶體區段的使用。
DxgkDdiQueryAdapterInfo 應設為可分頁。
支援 WDDM 2.6 和更新版本的所有驅動程式都必須實作 DxgkDdiQueryAdapterInfo 回 呼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平台 | 桌面 |
| 標頭 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |