DXGKDDI_VALIDATESUBMITCOMMAND Rückruffunktion (d3dkmddi.h)

  • Artikel

Die DXGKDDI_VALIDATESUBMITCOMMAND funktion des Anzeigeminiports (KMD) des Kernelmodus überprüft private Treiberdaten, die der Benutzermodustreiber (UMD) in Aufrufen von D3DKMTSubmitCommand oder D3DKMTSubmitCommandToHwQueue übergibt.

Syntax

DXGKDDI_VALIDATESUBMITCOMMAND DxgkddiValidatesubmitcommand;

NTSTATUS DxgkddiValidatesubmitcommand(
  IN_CONST_HANDLE hContext,
  INOUT_PDXGKARG_VALIDATESUBMITCOMMAND pArgs
)
{...}

Parameter

hContext

[in] Ein Handle für den Miniportgerätekontext, den der KMD von DxgkDdiAddDevice zurückgegeben hat.

pArgs

[in/out] Zeiger auf eine DXGKARG_VALIDATESUBMITCOMMAND-Struktur , die Informationen enthält, die zum Überprüfen des Submit-Befehls erforderlich sind.

Rückgabewert

DXGKDDI_VALIDATESUBMITCOMMAND gibt einen NTSTATUS-Wert zurück, z. B. einen der folgenden:

  • STATUS_SUCCESS
  • STATUS_INVALID_USER_BUFFER

Hinweise

Wenn der KMD diesen Rückruf implementiert, überprüft der KMD immer private Daten, die in Aufrufen an übergeben werden:

Dieser Rückruf wird nur aufgerufen, wenn die private Treibergröße (DmaBufferPrivateDataSize) in D3DKMTSubmitCommand nicht null ist.

Sie wird einmal pro D3DKMTSubmitCommand oder D3DKMTSubmitCommandToHwQueue aufgerufen.

Der KMD sollte nicht davon ausgehen, dass dieser Rückruf im Kontext des Prozesses aufgerufen wird, der D3DKMTSubmitCommand aufgerufen hat. Daher sollte die UMD keine Benutzermoduszeiger oder -handles in seinen privaten Daten übergeben.

Dieser Rückruf wird aufgerufen, bevor der Befehl zur Ausführung an die Softwarewarteschlange des GPU-Schedulers übermittelt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1809
Kopfzeile d3dkmddi.h
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGKARG_VALIDATESUBMITCOMMAND