DXGKCB_SYNCHRONIZE_EXECUTION Rückruffunktion (dispmprt.h)

Die DxgkCbSynchronizeExecution--Funktion synchronisiert eine angegebene Funktion, die vom Display miniport-Treiber 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 einen Anzeigeadapter darstellt. Der Display-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, der mit DxgkDdiInterruptRoutinesynchronisiert wird. Die Funktion muss dem folgenden Prototyp entsprechen:

BOOLEAN SynchronizeRoutine(PVOID Context);

[in] Context

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

[in] MessageNumber

Die Nummer der Unterbrechungsnachricht, mit der SynchronizeRoutine- synchronisiert werden. Wenn der Interrupt zeilenbasiert ist, muss dieser Parameter null sein.

[out] ReturnValue

Ein Zeiger auf eine boolesche Variable, die den Rückgabewert SynchronizeRoutineempfängt.

Rückgabewert

DxgkCbSynchronizeExecution gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
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
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Desktop
Header-	dispmprt.h (include Dispmprt.h)
IRQL-	<=DISPATCH_LEVEL

Siehe auch

DxgkDdiInterruptRoutine

KeSynchronizeExecution