共用方式為

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

另請參閱

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb