DXGKDDI_BUILDTESTCOMMANDBUFFER callback function (d3dkmddi.h)
KMD's DXGKDDI_BUILDTESTCOMMANDBUFFER function builds a test command buffer for kernel-mode testing.
Syntax
DXGKDDI_BUILDTESTCOMMANDBUFFER DxgkddiBuildtestcommandbuffer;
NTSTATUS DxgkddiBuildtestcommandbuffer(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_BUILDTESTCOMMANDBUFFER pArgs
)
{...}
Parameters
hAdapter
[in] A handle to a context block that is associated with a display adapter. The kernel-mode display miniport driver (KMD) previously provided this handle to Dxgkrnl in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.
pArgs
[in/out] Pointer to a DXGKARG_BUILDTESTCOMMANDBUFFER structure that describes the test command buffer to build.
Return value
DXGKDDI_BUILDTESTCOMMANDBUFFER returns NTSTATUS_SUCCESS if the function succeeds. Otherwise, it returns an appropriate NTSTATUS code such as STATUS_BUFFER_OVERFLOW.
Remarks
DXGKDDI_BUILDTESTCOMMANDBUFFER builds a command buffer with device-specific instructions for a set of simple commands. KMD returns a pointer to this function in pfnBuildTestCommandBuffer via DxgkDdiQueryFeatureInterface(DXGK_FEATURE_KERNEL_MODE_TESTING).
When pDmaBuffer is NULL or is too small, KMD needs to set the required size for the buffer in DmaBufferSize and return STATUS_BUFFER_OVERFLOW.
When pDmaBufferPrivateData is NULL or too small and KMD needs to generate private data, KMD needs to set the required size in DmaBufferPrivateDataSize and return STATUS_BUFFER_OVERFLOW.
The KMD must calculate the size of both buffers in the same call.
For more information, see Kernel-mode testing.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 11, version 24H2 (WDDM 3.2) |
Header | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |
See also
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour