IPort::Init 方法 (portcls.h)

Init 方法會初始化埠驅動程式。

語法

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

參數

DeviceObject

當做自變數傳遞至配接器驅動程式裝置啟動例程之裝置物件的指標。 裝置對像是類型為 DEVICE_OBJECT 的系統結構。

Irp

當做自變數傳遞至配接器驅動程式裝置啟動例程的 IRP 指標。

UnknownMiniport

未初始化迷你埠物件的IUnknown 介面指標。 此介面會查詢埠驅動程式所支援的特定迷你埠介面介面,並呼叫該介面上的初始化函式。

UnknownAdapter

要初始化埠驅動程式之配接器物件的IUnknown 介面指標。 此指標是選擇性的,可以指定為 NULL。 如需詳細資訊,請參閱接下來的<備註>一節。

ResourceList

傳遞為配接器驅動程式裝置啟動例程之自變數的 IResourceList 物件的指標。 將這個參考傳遞至迷你埠驅動程序之後,埠驅動程式即可自由檢查資源清單的內容,但不會修改此列表的內容。

傳回值

如果呼叫成功,這個方法會傳回NTSTATUS,其中包含STATUS_SUCCESS。 否則,方法會傳回適當的錯誤碼。

備註

UnknownMiniport 指定的迷你埠對象必須支援埠驅動程式所需的迷你埠介面,否則 Init 呼叫將會失敗。

在 IPort::Init 呼叫期間,埠驅動程式會呼叫迷你埠驅動程式的初始化方法 (例如,請參閱 IMiniportWavePci::Init) 。

參數 UnknownAdapter 指向配接器物件的 COM 介面。 配接器驅動程式通常會在其裝置啟動例程內建立此物件,這是操作系統呼叫以啟動裝置的例程 (請參閱啟動順序) 。 如需配接器物件的介面範例,請參閱 CMiniportWaveRT::Init sysvad 音訊驅動程式範例中的定義和實作。

UnknownMiniport、UnknownAdapter 和 ResourceList 參數遵循 COM 物件的標準參考計數慣例。

規格需求

需求
標頭 portcls.h
IRQL PASSIVE_LEVEL

另請參閱

IPort

IMiniportWavePci::Init