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