Metodo IPort::Init (portcls.h)
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 |