PMINIPORT_SYNCHRONIZE_ROUTINE funzione di callback (video.h)

Articolo
03/05/2024

HwVidSynchronizeExecutionCallback è una funzione di driver miniport facoltativa, passata nelle chiamate a VideoPortSynchronizeExecution.

Sintassi

PMINIPORT_SYNCHRONIZE_ROUTINE PminiportSynchronizeRoutine;

BOOLEAN PminiportSynchronizeRoutine(
  PVOID Context
)
{...}

Parametri

Context

Puntatore ai dati di contesto passati alla routine di callback tramite VideoPortSynchronizeExecution. In genere, questo è un puntatore all'estensione del dispositivo o un offset all'interno dell'estensione del dispositivo.

Valore restituito

Se l'operazione ha esito positivo, HwVidSynchronizeExecutionCallback restituisce TRUE.

Commenti

Un driver miniport con una o più funzioni che condividono memoria con la relativa funzione HwVidInterrupt deve avere una funzione HwVidSynchronizeExecutionCallback . Qualsiasi funzione che condivide la memoria con HwVidInterrupt deve chiamare VideoPortSynchronizeExecution con la funzione HwVidSynchronizeExecutionCallback per mantenere l'integrità dei dati nell'area di memoria condivisa. Vale a dire, solo una delle funzioni HwVidSynchronizeExecutionCallback e HwVidInterrupt può aggiornare lo stato nell'area condivisa in qualsiasi momento.

Il driver miniport di un adattatore che non genera interruzioni può avere anche una funzione HwVidSynchronizeExecutionCallback da passare a VideoPortSynchronizeExecution quando tale driver deve ottenere un lavoro critico eseguito con priorità relativamente elevata. Ad esempio, i driver miniport compatibili con VGA con funzioni SvgaHwIoPortXxx (vedere Funzioni SVGA) potrebbero avere una funzione HwVidSynchronizeExecutionCallback responsabile del trasferimento del buffer del driver e convalidato dell'I/O all'adattatore.

HwVidSynchronizeExecutionCallback non deve essere reso paginabile.