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 値を返します。 使用可能な値は次のとおりです。

リターン コード 説明
VFW_E_BADALIGN
 配置が無効です。
S_FALSE
 要求よりも少ないバイト数を取得しました。 (ファイルの末尾に到達した可能性があります)。
S_OK
 正常終了しました。

注釈

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

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

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

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)
Library Strmiids.lib

こちらもご覧ください

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

IAsyncReader インターフェイス