DXGKDDI_BUILDTESTCOMMANDBUFFER función de devolución de llamada (d3dkmddi.h)
La función DXGKDDI_BUILDTESTCOMMANDBUFFER de KMD compila un búfer de comandos de prueba para pruebas en modo kernel.
Sintaxis
DXGKDDI_BUILDTESTCOMMANDBUFFER DxgkddiBuildtestcommandbuffer;
NTSTATUS DxgkddiBuildtestcommandbuffer(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_BUILDTESTCOMMANDBUFFER pArgs
)
{...}
Parámetros
hAdapter
[in] Identificador de un bloque de contexto asociado a un adaptador de pantalla. Anteriormente, el controlador de minipuerto de pantalla en modo kernel (KMD) proporcionó este identificador para Dxgkrnl en el MiniportDeviceContext parámetro de salida del función DxgkDdiAddDevice.
pArgs
[in/out] Puntero a una estructura de DXGKARG_BUILDTESTCOMMANDBUFFER que describe el búfer de comandos de prueba que se va a compilar.
Valor devuelto
DXGKDDI_BUILDTESTCOMMANDBUFFER devuelve NTSTATUS_SUCCESS si la función se realiza correctamente. De lo contrario, devuelve un código NTSTATUS adecuado, como STATUS_BUFFER_OVERFLOW.
Observaciones
DXGKDDI_BUILDTESTCOMMANDBUFFER crea un búfer de comandos con instrucciones específicas del dispositivo para un conjunto de comandos simples. KMD devuelve un puntero a esta función en pfnBuildTestCommandBuffer a través de DxgkDdiQueryFeatureInterface(DXGK_FEATURE_KERNEL_MODE_TESTING).
Cuando pDmaBuffer es NULL o es demasiado pequeño, KMD debe establecer el tamaño necesario para el búfer en DmaBufferSize y devolver STATUS_BUFFER_OVERFLOW.
Cuando pDmaBufferPrivateData es NULL o demasiado pequeño y KMD necesita generar datos privados, KMD debe establecer el tamaño necesario en DmaBufferPrivateDataSize y devolver STATUS_BUFFER_OVERFLOW.
El KMD debe calcular el tamaño de ambos búferes en la misma llamada.
Para obtener más información, consulte pruebas en modo kernel.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 11, versión 24H2 (WDDM 3.2) |
| encabezado de | d3dkmddi.h |
| irQL | PASSIVE_LEVEL |