PMINIPORT_SYNCHRONIZE_ROUTINE funzione di callback (video.h)
HwVidSynchronizeExecutionCallback è una funzione driver miniport facoltativa, passata alle 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, si tratta di un puntatore all'estensione del dispositivo o di un offset all'interno dell'estensione del dispositivo.
Valore restituito
Se l'operazione ha esito positivo, HwVidSynchronizeExecutionCallback restituisce TRUE.
Osservazioni
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. Ovvero, solo una delle funzioni di HwVidSynchronizeExecutionCallback e HwVidInterrupt può aggiornare lo stato nell'area condivisa in qualsiasi momento.
Il driver miniport di un adattatore che non genera interrupt può anche avere un HwVidSynchronizeExecutionCallback funzione da passare a VideoPortSynchronizeExecution quando un driver di questo tipo deve eseguire alcune operazioni critiche a una priorità di runtime relativamente elevata. Ad esempio, i driver miniport compatibili con VGA con funzioni svgaHwIoPortXxx (vedere funzioni SVGA) potrebbero avere una funzione HwVidSynchronizeExecutionCallback responsabile del trasferimento dell'I/O rilasciato dal driver e convalidato all'adattatore.
HwVidSynchronizeExecutionCallback non deve essere reso impaginabile.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | video.h (includere Video.h) |