Metodo IMiniportWavePci::Init (portcls.h)

Articolo
03/05/2024

Il Init metodo inizializza l'oggetto miniport WavePci. L'inizializzazione include la verifica dell'hardware usando le risorse specificate nell'elenco di risorse.

Sintassi

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

Parametri

[in] UnknownAdapter

Puntatore all'interfaccia IUnknown dell'oggetto adapter il cui oggetto miniport viene inizializzato. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[in] ResourceList

Puntatore all'interfaccia IResourceList dell'oggetto elenco di risorse che deve essere fornito al driver miniport durante l'inizializzazione. 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. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[in] Port

Puntatore all'oggetto interfaccia IPortWavePci del driver di porta. Il chiamante specifica un valore di puntatore non NULL valido per questo parametro.

[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 viene registrato per la notifica di interruzione. Il chiamante specifica un valore di puntatore non NULL valido per questo parametro.

Valore restituito

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

Commenti

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

I parametri UnknownAdapter, ResourceList, Port e ServiceGroup seguono le convenzioni di conteggio dei riferimenti per gli oggetti COM.