Metodo IPortDMus::RegisterServiceGroup (dmusicks.h)

Articolo
08/07/2023

Il RegisterServiceGroup metodo registra un gruppo di servizi con il driver di porta DMus.

Sintassi

void RegisterServiceGroup(
  [in] PSERVICEGROUP ServiceGroup
);

Parametri

[in] ServiceGroup

Puntatore a un oggetto IServiceGroup . Si tratta del gruppo di servizi da registrare.

Valore restituito

nessuno

Osservazioni

Il driver miniport chiama il RegisterServiceGroup metodo per registrare un gruppo di servizi (oggetto IServiceGroup ) con il driver della porta. Il driver di porta può inserire uno o più sink del servizio (oggetti IServiceSink ) in questo gruppo di servizi. Il driver miniport invia una notifica (chiamando IPortDMus::Notify) al gruppo di servizi ogni volta che si verifica un interrupt. Al momento della ricezione della notifica, il gruppo di servizi pianifica una chiamata di procedura posticipata (DPC). Il DPC scorre tutti i sink del servizio nel gruppo di servizi e invia una notifica a ogni sink.

Il driver miniport chiama in genere RegisterServiceSink durante l'esecuzione del relativo metodo IMiniportDMus::Init . Lo scopo di questa chiamata è registrare il gruppo di servizi con il driver di porta abbastanza presto per iniziare a gestire gli interrupt non appena sono abilitati. Si noti che il gruppo di servizi restituito dal metodo Init non è disponibile per il driver di porta fino a quando non viene restituito dal metodo Init .

Se il driver miniport chiama RegisterServiceSink, il gruppo di servizi che il driver miniport passa al RegisterServiceSink metodo deve essere lo stesso che il driver miniport restituisce tramite il relativo metodo Init .

Un tipico driver miniport non ha più bisogno di chiamare RegisterServiceSink una volta che si è verificato il ritorno da IMiniportDMus::Init .

Vedi il driver audio di esempio DMusUART in Microsoft Windows Driver Kit (WDK) per un esempio di codice che mostra come il driver miniport chiama RegisterServiceSink dall'interno del relativo metodo IMiniportDMus::Init .

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