Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |