IMiniportMidi::Init メソッド (portcls.h)

[アーティクル]
08/07/2023

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

構文

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

パラメーター

[in] UnknownAdapter

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

[in] ResourceList

初期化中にミニポートドライバーに提供されるリソースリストオブジェクトの IResourceList インターフェイスへのポインター。ミニポートドライバーにこの参照を渡した後、ポートドライバーはリソースリストの内容を自由に調べることができますが、このリストの内容は変更されません。詳細については、「解説」を参照してください。

[in] Port

このミニポートオブジェクトにバインドされている IPortMidi オブジェクトへのポインター。呼び出し元は、このパラメーターの有効な NULL 以外のポインター値を指定します。

[out] ServiceGroup

サービスグループの出力ポインター。このパラメーターは、メソッドがミニポートドライバーのサービスグループオブジェクトの IServiceGroup インターフェイスへのポインターを書き込む呼び出し元によって割り当てられたポインター変数を指します。これは、割り込み通知用に登録されているサービスグループです。呼び出し元は、このパラメーターの有効な NULL 以外のポインター値を指定します。

戻り値

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

注釈

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

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

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

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

UnknownAdapter、ResourceList、Port、ServiceGroup の各パラメーターは、COM オブジェクトの参照カウント規則に従います。