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 會傳回下列其中一個值：

傳回碼	Description
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_UMDRIVERPRIVATE值。 此函式也會在 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
目標平台	桌面
標頭	d3dkmddi.h
IRQL	PASSIVE_LEVEL

另請參閱

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb