IMiniportWaveRT::NewStream メソッド (portcls.h)
メソッドは NewStream 、WaveRT ストリーム オブジェクトの新しいインスタンスを作成します。
構文
NTSTATUS NewStream(
[out] PMINIPORTWAVERTSTREAM *Stream,
[in] PPORTWAVERTSTREAM PortStream,
[in] ULONG Pin,
[in] BOOLEAN Capture,
[in] PKSDATAFORMAT DataFormat
);
パラメーター
[out] Stream
新しいストリームの出力ポインター。 このパラメーターは、呼び出し元によって割り当てられたポインター変数を指し、 NewStream メソッドが新しいストリーム オブジェクトの IMiniportWaveRTStream インターフェイスへのポインターを書き込みます。 呼び出し元は、このパラメーターの有効な NULL 以外のポインターを指定します。
[in] PortStream
IPortWaveRTStream へのポインター。
[in] Pin
開くピンを識別するピン ID を指定します。 WaveRT ミニポート ドライバーのフィルター記述子でフィルターに 対する n 個のピン ファクトリの合計が指定されている場合、 Pin パラメーターの有効な値は 0 ~ n-1 の範囲です。 フィルター記述子の詳細については、「 フィルター ファクトリ 」トピックを参照してください。
[in] Capture
キャプチャ ストリームとレンダー ストリームのどちらを作成するかを示すブール値を指定します。 このパラメーターは、キャプチャ (入力) ストリームの場合は TRUE 、再生 (出力) ストリームの 場合は FALSE です。
[in] DataFormat
新しいストリームのデータ形式を指定する KSDATAFORMAT 構造体へのポインター。 詳細については、「解説」を参照してください。
戻り値
NewStream は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、メソッドは適切なエラー状態コードを返します。
注釈
メソッドは NewStream 、ストリームの初期状態を KSSTATE_STOP に設定し、その初期位置を 0 に設定します。 詳細については、「関連するメソッド IMiniportWaveRTStream::SetState 」および 「IMiniportWaveRTStream::GetPosition」を参照してください。
ストリームのデータ形式を指定する DataFormat パラメーターは、KSDATAFORMAT 構造体の次のオーディオ固有の拡張バージョンのいずれかを指します。
Streamパラメーターと PortStream パラメーターは、COM オブジェクトの参照カウント規則に従います。要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降の Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | portcls.h |
| IRQL | パッシブ レベル。 |
こちらもご覧ください
IMiniportWaveRTStream
IMiniportWaveRTStream::GetPosition