PMINIPORT_SYNCHRONIZE_ROUTINE Rückruffunktion (video.h)

Artikel
02/07/2025

HwVidSynchronizeExecutionCallback ist eine optionale Miniporttreiberfunktion, die in Aufrufen an VideoPortSynchronizeExecutionübergeben wird.

Syntax

PMINIPORT_SYNCHRONIZE_ROUTINE PminiportSynchronizeRoutine;

BOOLEAN PminiportSynchronizeRoutine(
  PVOID Context
)
{...}

Parameter

Context

Zeiger auf Kontextdaten, die über VideoPortSynchronizeExecution-an die Rückrufroutine übergeben werden. In der Regel ist dies ein Zeiger auf die Geräteerweiterung oder ein Offset innerhalb der Geräteerweiterung.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt HwVidSynchronizeExecutionCallback-TRUE-zurück.

Bemerkungen

Ein Miniporttreiber mit einer oder mehreren Funktionen, die Arbeitsspeicher mit seiner HwVidInterrupt--Funktion teilen, muss über eine HwVidSynchronizeExecutionCallback--Funktion verfügen. Jede Funktion, die Arbeitsspeicher für HwVidInterrupt- freigibt, muss VideoPortSynchronizeExecution mit der funktion HwVidSynchronizeExecutionCallback aufrufen, um die Integrität von Daten im freigegebenen Speicherbereich beizubehalten. Das heißt, nur eine der HwVidSynchronizeExecutionCallback- und HwVidInterrupt- Funktionen können den Status im freigegebenen Bereich zu einem bestimmten Zeitpunkt aktualisieren.

Der Miniporttreiber eines Adapters, der keine Unterbrechungen generiert, kann auch eine HwVidSynchronizeExecutionCallback--Funktion aufweisen, die an VideoPortSynchronizeExecution übergeben werden soll, wenn ein solcher Treiber eine relativ hohe Laufzeitpriorität erreicht. Beispielsweise können VGA-kompatible Miniporttreiber mit SvgaHwIoPortXxx- Funktionen (siehe SVGA Functions) eine HwVidSynchronizeExecutionCallback--Funktion aufweisen, die für die Übertragung von treiberpufferten und validierten I/O-Dateien an den Adapter verantwortlich ist.

HwVidSynchronizeExecutionCallback- darf nicht seitenfähig gemacht werden.