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 構造体の次のオーディオ固有の拡張バージョンのいずれかを指します。

• KSDATAFORMAT_WAVEFORMATEX

• KSDATAFORMAT_DSOUND

要件

こちらもご覧ください

IMiniportWaveRT

IMiniportWaveRTStream

IMiniportWaveRTStream::GetPosition

IMiniportWaveRTStream::SetState

IPortWaveRTStream