DXGKDDI_BUILDTESTCOMMANDBUFFER Rückruffunktion (d3dkmddi.h)
Die DXGKDDI_BUILDTESTCOMMANDBUFFER-Funktion von KMD erstellt einen Testbefehlspuffer für Kernelmodustests.
Syntax
DXGKDDI_BUILDTESTCOMMANDBUFFER DxgkddiBuildtestcommandbuffer;
NTSTATUS DxgkddiBuildtestcommandbuffer(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_BUILDTESTCOMMANDBUFFER pArgs
)
{...}
Parameter
hAdapter
[in] Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Kernelmodus-Miniporttreiber (KMD) hat dieses Handle zuvor für Dxgkrnl- im MiniportDeviceContext Ausgabeparameter des DxgkDdiAddDevice-Funktion bereitgestellt.
pArgs
[in/out] Zeigen Sie auf eine DXGKARG_BUILDTESTCOMMANDBUFFER Struktur, die den zu erstellenden Testbefehlspuffer beschreibt.
Rückgabewert
DXGKDDI_BUILDTESTCOMMANDBUFFER gibt NTSTATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Code wie STATUS_BUFFER_OVERFLOW zurückgegeben.
Bemerkungen
DXGKDDI_BUILDTESTCOMMANDBUFFER erstellt einen Befehlspuffer mit gerätespezifischen Anweisungen für eine Reihe einfacher Befehle. KMD gibt einen Zeiger auf diese Funktion in pfnBuildTestCommandBuffer über DxgkDdiQueryFeatureInterface-(DXGK_FEATURE_KERNEL_MODE_TESTING) zurück.
Wenn pDmaBuffer- NULL oder zu klein ist, muss KMD die erforderliche Größe für den Puffer in DmaBufferSize- festlegen und STATUS_BUFFER_OVERFLOW zurückgeben.
Wenn pDmaBufferPrivateData- NULL oder zu klein ist und KMD private Daten generieren muss, muss KMD die erforderliche Größe in DmaBufferPrivateDataSize- festlegen und STATUS_BUFFER_OVERFLOW zurückgeben.
Der KMD muss die Größe beider Puffer im gleichen Aufruf berechnen.
Weitere Informationen finden Sie unter Kernelmodustests.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 11, Version 24H2 (WDDM 3.2) |
| Header- | d3dkmddi.h |
| IRQL- | PASSIVE_LEVEL |