IStreamSample

メモ このインターフェイスは非推奨です。

メモ このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。現在のサンプルを作成したメディアストリームオブジェクトへのポインターを取得します。

成功した場合は S_OK を、ppMediaStream が無効な場合は E_POINTER を返します。

成功した場合、このメソッドは ppMediaStream で指定されたメディアストリームの参照カウントをインクリメントします。

メモ このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。現在のサンプルの開始時刻と終了時刻を取得します。サンプルが更新中の場合、このメソッドは更新完了後の時刻を返します。

成功した場合は S_OK を、いずれかのパラメーターが無効な場合は E_POINTER を返します。

クロックを持つストリームの場合、開始時刻と終了時刻はストリームの現在時刻を基準とした相対値になります。ストリームがクロックを持たない場合、これらの時刻はメディアを基準とした相対値となり、現在時刻は 0 になります。

pCurrentTime パラメーターを使用すると、メディアストリームの現在時刻を手軽に追跡できるため、IMultiMediaStream::GetTime を呼び出す必要がありません。ただし GetTime とは異なり、ストリームがクロックを持たない場合、このメソッドは S_OK を返します(GetTime は S_FALSE を返します)。pCurrentTime に代入される値は、次のコード断片が生成する値と同じです。

IMediaStream *pMediaStream = 0;
hr = pSample->GetMediaStream(&pMediaStream);
if (SUCCEEDED(hr))
{
  IMultiMediaStream *pMultiMediaStream = 0;
  hr = pMediaStream->GetMultiMediaStream(&pMultiMediaStream);
  pMediaStream->Release();
  if (SUCCEEDED(hr))
  {
    STREAM_TIME CurrentTime = 0;
    hr = pMultiMediaStream->GetTime(&CurrentTime);
    pMultiMediaStream->Release();
  }
}

メモ このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。現在のサンプルの開始時刻と終了時刻を設定します。このメソッドはサンプルを更新する前に呼び出すことができます。

成功した場合は S_OK を、いずれかのパラメーターが NULL の場合は E_POINTER を返します。

クロックを持つストリームの場合、これらの時刻はストリームの現在時刻を基準とした相対値でなければなりません。ストリームがクロックを持たない場合、これらの時刻はメディアを基準とした相対値にする必要があります。

このメソッドは書き込み可能なストリームにのみ適用されます。

メモ このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。現在のサンプルに対して同期更新または非同期更新を実行します。

次のいずれかの値を返します。

このメソッドは、サンプルの同期更新または非同期更新を実行するために使用できます。hEvent と pfnAPC の両方が NULL の場合、SSUPDATE_ASYNC または SSUPDATE_CONTINUOUS フラグのいずれかが指定されていない限り、更新は同期で行われます。同期更新が復帰すると、関数の結果には I/O 完了ステータスが格納されます。

hEvent と pfnAPC の両方に値を指定することはできません。指定した場合、このメソッドは失敗します。

非同期更新は、更新が復帰する前に完了する場合があります。その場合、戻り値は S_OK になります。イベントを指定していて更新が S_OK を返す場合、このメソッドは復帰時にそのイベントをシグナル状態にします。APC 関数を指定していて更新が S_OK を返す場合、APC はキューに登録されず、関数は呼び出されません。

復帰前に完了しない非同期更新は、MS_S_PENDING の値を返します。

アプリケーションが複数のストリームを作成する場合は、各ストリームに対して非同期更新を実行する必要があります。次の更新を行う前に、各ストリームの更新が完了するのを待つには WaitForMultipleObjects を呼び出します。そうしないと、アプリケーションがブロックされる可能性があります。

メモ このインターフェイスは非推奨です。新しいアプリケーションでは使用しないでください。現在のサンプルの最新の非同期更新のステータスを取得します。更新が完了していない場合は、強制的に完了させることができます。

次のいずれかの値を返します。