Metodo IPortWaveCyclic::Notify (portcls.h)

Articolo
02/26/2024

Il Notify metodo notifica al driver di porta che si è verificato un interrupt che indica lo stato di avanzamento del puntatore DMA. Deve essere chiamato dalla routine del servizio di interrupt del driver miniport (ISR).

Sintassi

void Notify(
  [in] PSERVICEGROUP ServiceGroup
);

Parametri

[in] ServiceGroup

Puntatore all'oggetto IServiceGroup del driver miniport.

Valore restituito

nessuno

Osservazioni

Questo metodo è fondamentale per tempi accurati. I driver Miniport in genere chiamano questo metodo in risposta a un interrupt di notifica dopo aver cancellato l'origine di interrupt. Anche se il driver miniport è libero di usare altri metodi per determinare quando chiamare questo metodo, è importante e deve essere mantenuto un intervallo preciso.

Quando un driver dell'adattatore installa un ISR, invia un parametro ServiceContext insieme al punto di ingresso dell'ISR. Per informazioni dettagliate, vedere Fornire informazioni sul contesto ISR. Quando si verifica l'interrupt, il sistema operativo chiama l'ISR e passa ServiceContext come parametro di chiamata all'ISR. Anche se il significato del parametro ServiceContext è noto solo allo sviluppatore del driver, in genere è un puntatore all'oggetto miniport. L'ISR usa questo puntatore per accedere alle informazioni sull'oggetto miniport.

Il driver di porta chiama il metodo IMiniportWaveCyclicStream::SetNotificationFreq per specificare la frequenza con cui l'ISR deve chiamare il Notify metodo . In tutte le versioni correnti di Windows, il driver di porta specifica un intervallo regolare di 10 millisecondi tra le notifiche successive. Questo valore potrebbe cambiare in una versione futura.

Il parametro ServiceGroup segue le convenzioni di conteggio dei riferimenti per gli oggetti COM.