英語で読む

次の方法で共有

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

  • [アーティクル]

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 メソッドは、IInterruptSync インターフェイスについて、UnknownAdapter オブジェクトに対してクエリを実行します。
  • UnknownAdapter が NULL 場合、Init メソッドは PcNewInterruptSync 呼び出して、新しい IInterruptSync オブジェクトを作成します。 この場合、ResourceList リソース リストは、新しい IInterruptSync オブジェクトが使用する割り込みリソースを提供することを指します。
いずれの場合も、ミニポート ドライバーの割り込みサービス ルーチン (ISR) を割り込み同期ルーチンの一覧に追加するために、Init メソッドと呼び出し、IInterruptSync オブジェクトの RegisterServiceRoutine メソッド。 アダプター ドライバーが後でポート オブジェクトを解放すると、ポート ドライバーは、IInterruptSync オブジェクトへの参照を解放します。

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

UnknownAdapter、ResourceList、ポート、および serviceGroup パラメーターは、COM オブジェクト の参照カウント規則に従います。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー portcls.h (Portcls.h を含む)
IRQL PASSIVE_LEVEL

関連項目

IInterruptSync の

IMiniportMidi を する

IPort::Init

IPortMidi を する

IResourceList の

IServiceGroup の

PcNewInterruptSync