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

[アーティクル]
08/07/2023

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

構文

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

パラメーター

[out] Stream

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

[in, optional] OuterUnknown

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

[in] PoolType

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

[in] Pin

開くピンの番号。 WaveCyclic ミニポートドライバーの IMiniport::GetDescription メソッドがフィルター上の n 個のピンファクトリの合計を指定するフィルター記述子を出力する場合、パラメーター Pin の有効な値は 0 から n-1 の範囲です。

[in] Capture

キャプチャストリームとレンダーストリームのどちらを作成するかを指定します。このパラメーターは、キャプチャ (入力) チャネルの 場合は TRUE 、再生 (出力) チャネルの 場合は FALSE です。

[in] DataFormat

このインスタンスに使用する形式を示す KSDATAFORMAT 構造体へのポインター。

[out] DmaChannel

DMA チャネルへの出力ポインター。このパラメーターは、メソッドがミニポートドライバーの DMA チャネルオブジェクトの IDmaChannel インターフェイスへのポインターを書き込む呼び出し元によって割り当てられたポインター変数を指します。呼び出し元は、このパラメーターの有効な NULL 以外のポインター値を指定します。詳細については、「解説」を参照してください。

[out] ServiceGroup

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

戻り値

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

注釈

メソッドは NewStream 、ストリームの初期状態を KSSTATE_STOP に設定し、その初期位置を 0 に設定します。 ( 「IMiniportWaveCyclicStream::SetState 」および「IMiniportWaveCyclicStream::GetPosition」を参照してください)。

ポートドライバーは 、DmaChannel オブジェクトに対して次のメソッドのみを呼び出します。

IDmaChannel::AllocatedBufferSize

IDmaChannel::BufferSize

IDmaChannel::CopyFrom

IDmaChannel::CopyTo

IDmaChannel::SetBufferSize

IDmaChannel::SystemAddress

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