IMiniportDMus::Init メソッド (dmusicks.h)

[アーティクル]
02/23/2024

メソッドは Init 、DMus ミニポートオブジェクトを初期化します。

構文

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

パラメーター

[in, optional] UnknownAdapter

ミニポートオブジェクトが初期化されているアダプターオブジェクトの IUnknown インターフェイスへのポインター。このパラメーターは省略可能であり、 NULL として指定できます。詳細については、「解説」を参照してください。

[in] ResourceList

アダプターのリソースリストを含む IResourceList オブジェクトへのポインター。ミニポートドライバーにこの参照を渡した後、ポートドライバーはリソースリストの内容を自由に調べることができますが、このリストの内容は変更されません。

[in] Port

ポートドライバーのコールバックインターフェイスを提供する IPortDMus オブジェクトへのポインター。

[out] ServiceGroup

サービスグループの出力ポインター。このパラメーターは、メソッドがミニポートドライバーのサービスグループオブジェクトの IServiceGroup インターフェイスへのポインターを書き込む呼び出し元によって割り当てられたポインター変数を指します。これは、このミニポートドライバーが IPortDMus::Notify の呼び出しに使用するサービスグループです。

戻り値

Init は、呼び出しが成功した場合にS_OKを返します。それ以外の場合、メソッドは適切なエラーコードを返します。

注釈

pUnknownAdapter パラメーターは省略可能です。

pUnknownAdapter が NULL 以外の場合、Initメソッドは pUnknownAdapter オブジェクトの IInterruptSync インターフェイスを照会します。
pUnknownAdapter が NULL の場合、Initこのメソッドは PcNewInterruptSync を呼び出して新しい IInterruptSync オブジェクトを作成します。この場合、 pResourceList が指すリソースリストは、新しい IInterruptSync オブジェクトが使用する割り込みリソースを提供します。

どちらの場合も、 Init メソッドとは IInterruptSync オブジェクトの RegisterServiceRoutine メソッドを呼び出して、ミニポートドライバーの割り込みサービスルーチン (ISR) を ISR の一覧に追加します。アダプタードライバーが後でポートオブジェクトを解放すると、ポートドライバーは IInterruptSync オブジェクトへの参照を解放します。

pUnknownAdapter パラメーターと pResourceList パラメーターは、アダプタードライバーが以前に IPortDMus オブジェクトのInitメソッドにパラメーターとして渡したのと同じポインター値です (「IPort::Init」を参照)。

pUnknownAdapter、pResourceList、pPort、および ppServiceGroup パラメーターは、COM オブジェクトの参照カウント規則に従います。