DXGKDDI_BUILDTESTCOMMANDBUFFER回呼函式 （d3dkmddi.h）

KMD 的 DXGKDDI_BUILDTESTCOMMANDBUFFER 函式會建置測試命令緩衝區，以 核心模式測試。

語法

DXGKDDI_BUILDTESTCOMMANDBUFFER DxgkddiBuildtestcommandbuffer;

NTSTATUS DxgkddiBuildtestcommandbuffer(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_BUILDTESTCOMMANDBUFFER pArgs
)
{...}

參數

hAdapter

[in]與顯示配接器相關聯的內容區塊句柄。 核心模式顯示迷你埠驅動程式 （KMD） 先前提供此句柄，以 DxgkrnlMiniportDeviceContextDxgkDdiAddDevice 函式的輸出參數。

pArgs

[in/out]描述要建置之測試命令緩衝區之 DXGKARG_BUILDTESTCOMMANDBUFFER 結構的指標。

傳回值

如果函式成功，DXGKDDI_BUILDTESTCOMMANDBUFFER 會傳回NTSTATUS_SUCCESS。 否則，它會傳回適當的NTSTATUS程式代碼，例如STATUS_BUFFER_OVERFLOW。

言論

DXGKDDI_BUILDTESTCOMMANDBUFFER 使用一組簡單命令的裝置特定指示來建置命令緩衝區。 KMD 會透過 DxgkDdiQueryFeatureInterface（DXGK_FEATURE_KERNEL_MODE_TESTING） pfnBuildTestCommandBuffer 傳回此函式的指標。

pDmaBuffer 為 NULL 或太小時，KMD 必須在 DmaBufferS ize 中設定緩衝區所需的大小，並傳回STATUS_BUFFER_OVERFLOW。

當 pDmaBufferPrivateData 為 NULL 或太小，且 KMD 需要產生私人數據時，KMD 必須在 DmaBufferPrivateDataSize 中設定所需的大小， 並傳回STATUS_BUFFER_OVERFLOW。

KMD 必須計算相同呼叫中這兩個緩衝區的大小。

如需詳細資訊，請參閱 核心模式測試。

要求

另請參閱

DXGKARG_BUILDTESTCOMMANDBUFFER

DxgkDdiQueryFeatureInterface