Metodo IMiniportDMus::Init (dmusicks.h)

Articolo
02/25/2024

Il Init metodo inizializza l'oggetto miniport DMus.

Sintassi

NTSTATUS Init(
  [in, optional] PUNKNOWN      UnknownAdapter,
  [in]           PRESOURCELIST ResourceList,
  [in]           PPORTDMUS     Port,
  [out]          PSERVICEGROUP *ServiceGroup
);

Parametri

[in, optional] UnknownAdapter

Puntatore all'interfaccia IUnknown dell'oggetto adapter il cui oggetto miniport viene inizializzato. Questo parametro è facoltativo e può essere specificato come NULL. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[in] ResourceList

Puntatore a un oggetto IResourceList che contiene l'elenco di risorse dell'adapter. Dopo aver passato questo riferimento al driver miniport, il driver della porta è libero di esaminare il contenuto dell'elenco di risorse, ma non modifica il contenuto di questo elenco.

[in] Port

Puntatore a un oggetto IPortDMus che fornisce l'interfaccia di callback del driver di porta.

[out] ServiceGroup

Puntatore di output per il gruppo di servizi. Questo parametro punta a una variabile puntatore allocata dal chiamante in cui il metodo scrive un puntatore all'interfaccia IServiceGroup dell'oggetto del gruppo di servizi del driver miniport. Si tratta del gruppo di servizi che questo driver miniport vuole avere usato per le chiamate a IPortDMus::Notify.

Valore restituito

Init restituisce S_OK se la chiamata ha esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.

Commenti

Il parametro pUnknownAdapter è facoltativo:

Se pUnknownAdapter non è NULL, il Init metodo esegue una query sull'oggetto pUnknownAdapter per l'interfaccia IInterruptSync .
Se pUnknownAdapter è NULL, il Init metodo chiama PcNewInterruptSync per creare un nuovo oggetto IInterruptSync . In questo caso, l'elenco di risorse che pResourceList punta a specificare la risorsa di interruzione usata dal nuovo oggetto IInterruptSync .

In entrambi i casi, il metodo e chiama il Init metodo RegisterServiceRoutine nell'oggetto IInterruptSync per aggiungere la routine di interruzione del driver miniport (ISR) all'elenco di ISR. Quando il driver dell'adattatore libera l'oggetto porta, il driver di porta rilascia il riferimento all'oggetto IInterruptSync .

I parametri pUnknownAdapter e pResourceList sono gli stessi valori del puntatore passati in precedenza al metodo dell'oggetto InitIPortDMus ( vedere IPort::Init).

I parametri pUnknownAdapter, pResourceList, pPort e ppServiceGroup seguono le convenzioni di conteggio dei riferimenti per gli oggetti COM.