IMFSourceReader::ReadSample メソッド (mfreadwrite.h)

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

メディアソースから次のサンプルを読み取ります。

構文

HRESULT ReadSample(
  [in]  DWORD     dwStreamIndex,
  [in]  DWORD     dwControlFlags,
  [out] DWORD     *pdwActualStreamIndex,
  [out] DWORD     *pdwStreamFlags,
  [out] LONGLONG  *pllTimestamp,
  [out] IMFSample **ppSample
);

パラメーター

[in] dwStreamIndex

データをプルするストリーム。値には、次のいずれかを指定できます。

値	意味
0 ~ 0xFFFFFFFB	ストリームの 0 から始まるインデックス。
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	最初のビデオストリーム。
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	最初のオーディオストリーム。
MF_SOURCE_READER_ANY_STREAM 0xFFFFFFFE	どのストリームに関係なく、次に使用可能なサンプルを取得します。

[in] dwControlFlags

MF_SOURCE_READER_CONTROL_FLAG列挙体からの 0 個以上のフラグのビットごとの OR。

[out] pdwActualStreamIndex

ストリームの 0 から始まるインデックスを受け取ります。

[out] pdwStreamFlags

MF_SOURCE_READER_FLAG列挙から 0 個以上のフラグのビットごとの OR を受け取ります。

[out] pllTimestamp

サンプルのタイムスタンプ、または pdwStreamFlags で示されるストリームイベントの時刻を受け取ります。時間は 100 ナノ秒単位で指定されます。

[out] ppSample

IMFSample インターフェイスまたは値 NULL へのポインターを受け取ります (「解説」を参照)。このパラメーターが NULL 以外のポインターを受け取る場合、呼び出し元はインターフェイスを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
MF_E_INVALIDREQUEST	無効な要求です。
MF_E_INVALIDSTREAMNUMBER	dwStreamIndex パラメーターが無効です。
MF_E_NOTACCEPTING	フラッシュ操作が保留中です。「IMFSourceReader::Flush」を参照してください。
E_INVALIDARG	引数が無効です。「解説」を参照してください。

Remarks

要求されたストリームが選択されていない場合、戻りコードは MF_E_INVALIDREQUEST。「IMFSourceReader::SetStreamSelection」を参照してください。

このメソッドは、同期的または非同期的に完了できます。ソースリーダーの作成時にコールバックポインターを指定すると、メソッドは非同期になります。それ以外の場合、メソッドは同期です。コールバックポインターの設定の詳細については、「 MF_SOURCE_READER_ASYNC_CALLBACK」を参照してください。

非同期モード

非同期モードの場合:

すべてのパラメーターは [out]NULL である必要があります。それ以外の場合、メソッドは E_INVALIDARGを返します。
メソッドは直ちにを返します。
操作が完了すると、アプリケーションの IMFSourceReaderCallback::OnReadSample メソッドが呼び出されます。
エラーが発生した場合、メソッドは同期的または非同期的に失敗する可能性があります。 ReadSample の戻り値を確認し、IMFSourceReaderCallback::OnReadSample の hrStatus パラメーターもチェックします。

同期モード

同期モードの場合:

pdwStreamFlags パラメーターと ppSample パラメーターを NULL にすることはできません。それ以外の場合、メソッドは E_POINTERを返します。
pdwActualStreamIndex パラメーターとpllTimestamp パラメーターは NULL にすることができます。
メソッドは、次のサンプルが使用可能になるまでブロックします。

同期モードでは、dwStreamIndex パラメーターがMF_SOURCE_READER_ANY_STREAMされている場合は、サンプルを配信したストリームを把握できるように、pdwActualStreamIndex に NULL 以外の値を渡す必要があります。

このメソッドは、ppSample でメディアサンプルを返すことなく、pdwStreamFlags パラメーターでフラグを返すことができます。したがって、 ppSample パラメーターは、メソッドが成功した場合でも NULL ポインターを受け取ることができます。たとえば、ソースリーダーがストリームの末尾に達すると、pdwStreamFlags で MF_SOURCE_READERF_ENDOFSTREAM フラグが返され、ppSample がNULL に設定されます。

ストリームにギャップがある場合、 pdwStreamFlags はMF_SOURCE_READERF_STREAMTICK フラグを受け取り、 ppSample は NULL、 pllTimestamp はギャップが発生した時刻を示します。

このインターフェイスは、Windows Vista のプラットフォーム更新プログラムの補足がインストールされている場合に、Windows Vista で使用できます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 用 Windows 7、Windows Vista およびプラットフォーム更新プログラムの補足 [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfreadwrite.h

こちらもご覧ください

IMFSourceReader

ソースリーダー

次の方法で共有