Metodo IPortWavePci::Notify (portcls.h)

Articolo
02/29/2024

Il Notify metodo notifica al driver di porta che si è verificato un interruzione che indica lo stato di avanzamento del puntatore DMA.

Sintassi

void Notify(
  [in] PSERVICEGROUP ServiceGroup
);

Parametri

[in] ServiceGroup

Puntatore all'oggetto IServiceGroup del driver miniport.

Valore restituito

nessuno

Osservazioni

Alcuni driver miniport chiamano questo metodo da un ISR in risposta a un interruzione hardware dopo aver cancellato l'origine dell'interruzione. Altri driver chiamano questo metodo da un DPC timer pianificato per l'esecuzione a intervalli regolari. Come regola generale, solo i driver che gestiscono un singolo flusso di rendering da KMixer devono basarsi su interruzioni hardware. I driver che supportano l'accelerazione hardware DirectSound devono disattivare gli interruzioni hardware e usare invece i DPC timer. Per altre informazioni, vedere IPortWavePciStream::GetMapping.

Anche se il driver miniport è libero di scegliere la propria tecnica per determinare quando chiamare questo metodo, questo metodo deve essere chiamato abbastanza frequentemente per consentire al driver di porta di attivare la posizione in sospeso e gli eventi di orologio a intervalli regolari. La tempistica per questo metodo non è fondamentale perché è per il metodo IPortWaveCyclic::Notify , tuttavia.

Quando un driver dell'adapter 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'interruzione, il sistema operativo chiama ISR e passa ServiceContext come parametro di chiamata all'ISR. Anche se il significato del parametro ServiceContext è noto solo per lo sviluppatore del driver, in genere è un puntatore all'oggetto miniport. L'ISR usa questo puntatore per accedere alle informazioni sull'oggetto miniport.

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