DXGKDDI_QUERYADAPTERINFO回呼函式 (d3dkmddi.h)

DxgkDdiQueryAdapterInfo函式會從圖形配接器擷取組態資訊。

語法

DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;

NTSTATUS DxgkddiQueryadapterinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}

參數

[in] hAdapter

與顯示配接器相關聯的內容區塊控制碼。 顯示迷你埠驅動程式先前已將此控制碼提供給DxgkDdiAddDevice函式之MiniportDeviceCoNtext輸出參數中的 Microsoft DirectX 圖形核心子系統。

[in] pQueryAdapterInfo

顯示迷你埠驅動程式填滿圖形配接器組態資訊的 DXGKARG_QUERYADAPTERINFO 結構的指標。

傳回值

DxgkDdiQueryAdapterInfo 會傳回下列其中一個值:

傳回碼 描述
STATUS_SUCCESS DxgkDdiQueryAdapterInfo 已成功擷取組態資訊。
STATUS_INVALID_PARAMETER 傳遞至 DxgkDdiQueryAdapterInfo 的參數包含防止它完成的錯誤。
STATUS_NO_MEMORY DxgkDdiQueryAdapterInfo 無法配置完成所需的記憶體。
STATUS_GRAPHICS_DRIVER_MISMATCH 顯示迷你埠驅動程式與起始對 DxgkDdiQueryAdapterIn (fo 呼叫的使用者模式顯示驅動程式不相容,也就是為顯示迷你埠驅動程式) 提供查詢的私人資料。

備註

當使用者模式顯示驅動程式呼叫 pfnQueryAdapterInfoCb 函式時,會起始對 DxgkDdiQueryAdapterInfo 函式的呼叫。 DxgkDdiQueryAdapterInfo會接收pQueryAdapterInfo參數指向之 DXGKARG_QUERYADAPTERINFO 結構之 Type成員中的DXGKQAITYPE_UMDRIVERPRI加值稅E值。 此函式也會在 pOutputData 成員中接收專屬緩衝區,該成員會填入使用者模式顯示驅動程式識別介面卡所需的組態資訊。

如果 DirectX 圖形核心子系統 (屬於Dxgkrnl.sys) 在子系統呼叫DxgkDdiQueryAdapterInfo時,指定 DXGKARG_QUERYADAPTERINFO Type成員中的DXGKQAITYPE_DRIVERCAPS值,則顯示迷你埠驅動程式應該填入提供的DXGK_DRIVERCAPS結構,並包含子系統可以使用的資訊。

如果 DirectX 圖形核心子系統在 DXGKARG_QUERYADAPTERINFO 的 Type 成員中提供DXGKQAITYPE_QUERYSEGMENT值,則顯示迷你埠驅動程式應該提供其支援的記憶體區段相關資訊。 如需記憶體區段的詳細資訊,請參閱 初始化記憶體區段的使用

DxgkDdiQueryAdapterInfo 應該可分頁。

注意

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

必要條件

   
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平臺 桌面
標頭 d3dkmddi.h
IRQL PASSIVE_LEVEL

另請參閱

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb