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に設定します。
Stream、OuterUnknown、および ServiceGroup パラメーターは、COM オブジェクト の参照カウント規則に従います。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | portcls.h (Portcls.h を含む) |
| IRQL | PASSIVE_LEVEL |
関連項目
IMiniportMidi を する
IMiniportMidiStream の
IServiceGroup の