DXGKDDI_DESCRIBEALLOCATION回呼函式 (d3dkmddi.h)

發行項
02/26/2024

DxgkDdiDescribeAllocation 函式會擷取 Microsoft DirectX 圖形核心子系統無法使用的現有配置相關信息。

語法

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

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

參數

[in] hAdapter

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

[in/out] pDescribeAllocation

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

傳回值

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

備註

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

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

DxgkDdiDescribeAllocation 應設為可分頁。