Metodo IPort::Init (portcls.h)

  • Articolo

Il metodo Init inizializza il driver della porta.

Sintassi

NTSTATUS Init(
  PVOID         DeviceObject,
  PVOID         Irp,
  PUNKNOWN      UnknownMiniport,
  PUNKNOWN      UnknownAdapter,
  PRESOURCELIST ResourceList
);

Parametri

DeviceObject

Puntatore all'oggetto dispositivo passato come argomento alla routine di avvio del dispositivo del driver dell'adattatore. L'oggetto dispositivo è una struttura di sistema di tipo DEVICE_OBJECT.

Irp

Puntatore all'IRP passato come argomento alla routine di avvio del dispositivo del driver dell'adattatore.

UnknownMiniport

Puntatore all'interfaccia IUnknown dell'oggetto miniport non inizializzato. Questa interfaccia viene eseguita una query per l'interfaccia miniport specifica supportata dal driver di porta e viene chiamata la funzione di inizializzazione su tale interfaccia.

UnknownAdapter

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

ResourceList

Puntatore all'oggetto IResourceList passato come argomento alla routine device-startup del driver dell'adattatore. Dopo aver passato questo riferimento al driver miniport, il driver della porta è libero di esaminare il contenuto dell'elenco di risorse, ma non modificherà il contenuto di questo elenco.

Valore restituito

Questo metodo restituisce NTSTATUS che contiene STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.

Commenti

L'oggetto miniport specificato da UnknownMiniport deve supportare l'interfaccia miniport richiesta dal driver della porta o la chiamata Init avrà esito negativo.

Durante la chiamata IPort::Init, il driver della porta chiama il metodo di inizializzazione del driver miniport(ad esempio, vedere IMiniportWavePci::Init).

Il parametro UnknownAdapter punta all'interfaccia COM di un oggetto adapter. Il driver dell'adattatore crea in genere questo oggetto all'interno della routine di avvio del dispositivo, ovvero la routine che il sistema operativo chiama per avviare il dispositivo (vedere Sequenza di avvio). Per un esempio di interfaccia per un oggetto adapter, vedere la definizione e l'implementazione CMiniportWaveRT::Init nell'esempio di driver audio sysvad.

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

Requisiti

Requisito Valore
Intestazione portcls.h
IRQL PASSIVE_LEVEL

Vedi anche

IPort

IMiniportWavePci::Init