次の方法で共有


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

メソッドは NewStream 、指定された物理チャネルに関連付けられた論理ストリームの新しいインスタンスを作成します。

構文

NTSTATUS NewStream(
  [out]          PMINIPORTMIDISTREAM *Stream,
  [in, optional] PUNKNOWN            OuterUnknown,
  [in]           POOL_TYPE           PoolType,
  [in]           ULONG               Pin,
  [in]           BOOLEAN             Capture,
  [in]           PKSDATAFORMAT       DataFormat,
  [out]          PSERVICEGROUP       *ServiceGroup
);

パラメーター

[out] Stream

新しいストリームの出力ポインター。 このパラメーターは、メソッドがストリーム オブジェクトの IMiniportMidiStream インターフェイスへのポインターを書き込む呼び出し元によって割り当てられたポインター変数を指します。

[in, optional] OuterUnknown

ストリーム オブジェクトを集計する必要があるオブジェクトの IUnknown インターフェイスへのポインター。 このパラメーターは省略可能です。 集計が必要ない場合、呼び出し元はこのパラメーターを NULL として指定します。

[in] PoolType

DMA チャネル オブジェクトの記憶域の割り当て元となるメモリ プールの種類を指定します。 このパラメーターは、 POOL_TYPE 列挙値のいずれかに設定されます。

[in] Pin

ピン ID を指定します。 このパラメーターは、開くピンを識別します。 MIDI ミニポート オブジェクトの IMiniport::GetDescription メソッドがフィルター上の n 個のピン ファクトリの合計を指定するフィルター記述子を出力する場合、有効なピン ID の範囲は 0 ~ n-1 です。

[in] Capture

キャプチャまたは再生にチャネルを使用するかどうかを指定します。 TRUE の場合は、キャプチャ (入力) チャネルです。 FALSE の場合は、再生 (出力) チャネルです。

[in] DataFormat

このストリーム インスタンスに使用するデータ形式を指定する KSDATAFORMAT 構造体へのポインター。

[out] ServiceGroup

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

戻り値

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

注釈

メソッドは NewStream 、ストリームの初期状態をKSSTATE_STOPに設定します。

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

要件

要件
対象プラットフォーム ユニバーサル
Header portcls.h (Portcls.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

IMiniport::GetDescription

IMiniportMidi

IMiniportMidiStream

IServiceGroup

KSDATAFORMAT

POOL_TYPE