IAsyncReader::SyncReadAligned メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

メソッドは SyncReadAligned 同期読み取りを実行します。 メソッドは、要求が完了するまでブロックします。 ファイルの位置とバッファー アドレスを揃える必要があります。必要なアラインメントのアロケーター プロパティをチェックします。

構文

HRESULT SyncReadAligned(
  IMediaSample *pSample
);

パラメーター

pSample

呼び出し元によって提供されるメディア サンプルの IMediaSample インターフェイスへのポインター。

戻り値

HRESULT 値を返します。 使用可能な値は次のとおりです。

注釈

このメソッドを呼び出す前に、ピンのアロケーターからメディア サンプルを取得します。 要求しているバイト オフセット (最初と最後を含む) に 10,000,000 を乗算したサンプルのタイムスタンプ。 バイト オフセットは、ストリームの先頭からの相対位置です。

開始位置と停止位置は、ピンが接続されたときに決定されたアラインメントと一致する必要があります。 それ以外の場合、メソッドは VFW_E_BADALIGNを返します。 合意されたアラインメントがストリームの実際のアラインメントよりも粗い場合、停止位置は実際の継続時間を超える可能性があります。 その場合、メソッドは停止位置を実際の配置に丸めます。

このメソッドはバッファーなしの読み取りを実行するため、 IAsyncReader::SyncRead メソッドよりも高速な場合があります。

要件

こちらもご覧ください

エラーコードと成功コード

IAsyncReader インターフェイス