DXGKDDI_DESCRIBEALLOCATION回呼函式（d3dkmddi.h）

發行項
02/06/2025

DxgkDdiDescribeAllocation 函式會擷取現有配置的相關信息，該配置不適用於 Microsoft DirectX 圖形核心子系統。

語法

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

NTSTATUS DxgkddiDescribeallocation(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_DESCRIBEALLOCATION pDescribeAllocation
)
{...}

參數

[in] hAdapter

與顯示配接器相關聯的內容區塊句柄。顯示迷你埠驅動程式先前已提供此句柄給 MiniportDeviceContextDxgkDdiAddDevice 函式的 DirectX 圖形核心子系統。

[in/out] pDescribeAllocation

描述現有配置之 DXGKARG_DESCRIBEALLOCATION 結構的指標。

傳回值

DxgkDdiDescribeAllocation 如果成功，則會傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h中定義的其中一個錯誤碼。

言論

由於 DirectX 圖形核心子系統不一定維護配置記錄，因此圖形核心子系統會呼叫 DxgkDdiDescribeAllocation，要求顯示迷你埠驅動程式傳回現有配置的相關信息。目前，顯示迷你埠驅動程序必須能夠針對下列配置傳回這項資訊：

也是主要配置（也就是，在呼叫 pfnAllocateCb 函式時，設定主要位字段 旗標所建立之使用者模式顯示驅動程式的配置D3DDDI_ALLOCATIONINFO 結構的成員）。
可能是簡報來源的配置（也就是，在呼叫顯示迷你埠驅動程式的 DxgkDdiPresent 函式中，hSource 所代表的配置 DXGKARG_PRESENT 結構 成員）。

DxgkDdiDescribeAllocation 應設為可分頁。