共用方式為


DXGKDDI_QUERYADAPTERINFO回呼函式 (d3dkmddi.h)

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 函式的呼叫。

  • 如果 DxgkrnlDXGKARG_QUERYADAPTERINFO::Type中指定DXGKQAITYPE_UMDRIVERPRIVATE,pOutputData 指向 KMD 填入 UMD 識別配接器所需設定資訊的專屬結構。

  • 如果 DxgkrnlDXGKARG_QUERYADAPTERINFO::Type中指定DXGKQAITYPE_DRIVERCAPS,KMD 應該以子系統可以使用的資訊填入提供的 DXGK_DRIVERCAPS 結構。

  • 如果 DxgkrnlDXGKARG_QUERYADAPTERINFO::Type中指定DXGKQAITYPE_QUERYSEGMENT,KMD 應該提供其支援的記憶體區段相關信息。 如需記憶體區段的詳細資訊,請參閱 初始化記憶體區段

DxgkDdiQueryAdapterInfo 應設為可分頁。

支援 WDDM 2.6 和更新版本的所有驅動程式都必須實作 DxgkDdiQueryAdapterInfo 回呼。

要求

要求 價值
最低支援的用戶端 Windows Vista (WDDM 1.0)
目標平臺 桌面
標頭 d3dkmddi.h
IRQL PASSIVE_LEVEL

另請參閱

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb