DXGKCB_SYNCHRONIZE_EXECUTION Rückruffunktion (dispmprt.h)

  • Artikel

Die DxgkCbSynchronizeExecution-Funktion synchronisiert eine angegebene Funktion, die vom Anzeigeminiporttreiber implementiert wird, mit der DxgkDdiInterruptRoutine-Funktion des Anzeigeminiporttreibers.

Syntax

DXGKCB_SYNCHRONIZE_EXECUTION DxgkcbSynchronizeExecution;

NTSTATUS DxgkcbSynchronizeExecution(
  [in]  HANDLE DeviceHandle,
  [in]  PKSYNCHRONIZE_ROUTINE SynchronizeRoutine,
  [in]  PVOID Context,
  [in]  ULONG MessageNumber,
  [out] PBOOLEAN ReturnValue
)
{...}

Parameter

[in] DeviceHandle

Ein Handle, das eine Grafikkarte darstellt. Der Anzeige-Miniporttreiber hat dieses Handle zuvor im DeviceHandle-Member der DXGKRNL_INTERFACE-Struktur abgerufen, die an DxgkDdiStartDevice übergeben wurde.

[in] SynchronizeRoutine

Ein Zeiger auf eine Funktion, die vom Anzeigeminiporttreiber implementiert wird und mit DxgkDdiInterruptRoutine synchronisiert wird. Die Funktion muss dem folgenden Prototyp entsprechen:

BOOLEAN SynchronizeRoutine(PVOID Context);

[in] Context

Ein Zeiger auf einen Kontextblock, der vom Anzeigeminiporttreiber erstellt wird und an SynchronizeRoutine übergeben wird.

[in] MessageNumber

Die Nummer der Interruptmeldung, mit der SynchronizeRoutine synchronisiert wird. Wenn der Interrupt zeilenbasiert ist, muss dieser Parameter null sein.

[out] ReturnValue

Ein Zeiger auf eine boolesche Variable, die den Rückgabewert von SynchronizeRoutine empfängt.

Rückgabewert

DxgkCbSynchronizeExecution gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Die Funktion wurde erfolgreich ausgeführt.
STATUS_INVALID_PARAMETER Einer der Parameter ist ungültig.
STATUS_UNSUCCESSFUL Die Funktion konnte die Ausführung nicht synchronisieren, möglicherweise weil der Interrupt noch nicht verbunden war.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile dispmprt.h (include Dispmprt.h)
IRQL <=DISPATCH_LEVEL

Weitere Informationen

DxgkDdiInterruptRoutine

KeSynchronizeExecution