DXGKDDI_BUILDTESTCOMMANDBUFFER função de retorno de chamada (d3dkmddi.h)
A função DXGKDDI_BUILDTESTCOMMANDBUFFER do KMD cria um buffer de comando de teste para de teste no modo kernel.
Sintaxe
DXGKDDI_BUILDTESTCOMMANDBUFFER DxgkddiBuildtestcommandbuffer;
NTSTATUS DxgkddiBuildtestcommandbuffer(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_BUILDTESTCOMMANDBUFFER pArgs
)
{...}
Parâmetros
hAdapter
[in] Um identificador para um bloco de contexto associado a um adaptador de exibição. O KMD (driver de miniporto de exibição) do modo kernel forneceu anteriormente esse identificador para Dxgkrnl no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice.
pArgs
[entrada/saída] Ponteiro para uma estrutura de DXGKARG_BUILDTESTCOMMANDBUFFER que descreve o buffer de comando de teste a ser compilado.
Valor de retorno
DXGKDDI_BUILDTESTCOMMANDBUFFER retornará NTSTATUS_SUCCESS se a função for bem-sucedida. Caso contrário, ele retornará um código NTSTATUS apropriado, como STATUS_BUFFER_OVERFLOW.
Observações
DXGKDDI_BUILDTESTCOMMANDBUFFER cria um buffer de comando com instruções específicas do dispositivo para um conjunto de comandos simples. KMD retorna um ponteiro para essa função em pfnBuildTestCommandBuffer via DxgkDdiQueryFeatureInterface (DXGK_FEATURE_KERNEL_MODE_TESTING).
Quando pDmaBuffer é NULL ou é muito pequeno, o KMD precisa definir o tamanho necessário para o buffer em DmaBufferSize e retornar STATUS_BUFFER_OVERFLOW.
Quando pDmaBufferPrivateData for NULL ou muito pequeno e o KMD precisar gerar dados privados, o KMD precisará definir o tamanho necessário em DmaBufferPrivateDataSize e retornar STATUS_BUFFER_OVERFLOW.
O KMD deve calcular o tamanho de ambos os buffers na mesma chamada.
Para obter mais informações, consulte de teste no modo Kernel.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 11, versão 24H2 (WDDM 3.2) |
| cabeçalho | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |