1 つ以上のストリームをフラッシュします。
構文
HRESULT Flush(
[in] DWORD dwStreamIndex
);
パラメーター
[in] dwStreamIndex
フラッシュするストリーム。 値には、次のいずれかを指定できます。
戻り値
このメソッドが成功した場合は、S_OKを返します。 それ以外の場合は、HRESULT エラー コードが返されます。
注釈
Flush メソッドは、キューに登録されているすべてのサンプルを破棄し、保留中のすべてのサンプル要求を取り消します。
このメソッドは、同期的または非同期的に完了できます。
ソース リーダーの作成時にコールバック ポインターを指定すると、メソッドは非同期になります。 それ以外の場合、メソッドは同期です。 コールバック ポインターの設定の詳細については、 MF_SOURCE_READER_ASYNC_CALLBACKを参照してください。
同期モードでは、メソッドは操作が完了するまでブロックします。
非同期モードでは、フラッシュ操作が完了すると、アプリケーションの IMFSourceReaderCallback::OnFlush メソッドが呼び出されます。 フラッシュ操作が保留中の間、 IMFSourceReader::ReadSample メソッドは MF_E_NOTACCEPTINGを返します。
手記 Windows 7 では、このメソッドの実装にバグがありました。これにより、フラッシュ操作が完了する前に OnFlush が呼び出されます。 以前は、そのバグを修正した修正プログラムを使用できます。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 用 Windows 7、Windows Vista およびプラットフォーム更新プログラムの補足 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ] |
| ターゲット プラットフォーム の | ウィンドウズ |
| Header | mfreadwrite.h |
こちらも参照ください
IMFSourceReader の