PMINIPORT_SYNCHRONIZE_ROUTINE Rückruffunktion (video.h)

Artikel
02/26/2024

HwVidSynchronizeExecutionCallback ist eine optionale Miniporttreiberfunktion, die in Aufrufen von 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. Normalerweise ist dies ein Zeiger auf die Geräteerweiterung oder ein Offset innerhalb der Geräteerweiterung.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt HwVidSynchronizeExecutionCallbackTRUE zurück.

Hinweise

Ein Miniporttreiber mit einer oder mehreren Funktionen, die Arbeitsspeicher mit seiner HwVidInterrupt-Funktion gemeinsam nutzen, muss über eine HwVidSynchronizeExecutionCallback-Funktion verfügen. Jede Funktion, die Arbeitsspeicher mit HwVidInterrupt gemeinsam verwendet, muss VideoPortSynchronizeExecution mit der HwVidSynchronizeExecutionCallback-Funktion aufrufen, um die Integrität der Daten im Freigegebenen Speicherbereich aufrechtzuerhalten. Das heißt, nur eine der Funktionen HwVidSynchronizeExecutionCallback und HwVidInterrupt kann den Zustand im freigegebenen Bereich zu einem bestimmten Zeitpunkt aktualisieren.

Der Miniporttreiber eines Adapters, der keine Interrupts generiert, kann auch über eine HwVidSynchronizeExecutionCallback-Funktion verfügen, die an VideoPortSynchronizeExecution übergeben wird, wenn ein solcher Treiber kritische Arbeit mit einer relativ hohen Laufzeitpriorität erledigen muss. Beispielsweise können VGA-kompatible Miniporttreiber mit SvgaHwIoPortXxx-Funktionen (siehe SVGA-Funktionen) über eine HwVidSynchronizeExecutionCallback-Funktion verfügen, die für die Übertragung von treibergepufferten und überprüften von der Anwendung ausgestellten E/A auf den Adapter verantwortlich ist.

HwVidSynchronizeExecutionCallback darf nicht als ausgelagert werden.