Win32 API 日本語リファレンス
ホーム › Media.MediaFoundation › IMFByteStreamCacheControl2

IMFByteStreamCacheControl2

COM
📘 Microsoft Learn (日本語) · English
IID71ce469c-f34b-49ea-a56b-2d2a10e51149継承元IMFByteStreamCacheControl自前メソッド開始 vtbl4

公式ドキュメント

ネットワークバイトストリームがローカルキャッシュへデータを転送する方法を制御します。(IMFByteStreamCacheControl2)

解説(Remarks)

Microsoft Media Foundation のバイトストリームオブジェクトは、このインターフェイスを任意で実装できます。このインターフェイスへのポインターを取得するには、バイトストリームオブジェクトに対して QueryInterface を呼び出します。

メソッド 3

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 4 HRESULT GetByteRanges(DWORD* pcRanges, MF_BYTE_STREAM_CACHE_RANGE** ppRanges)

現在キャッシュに格納されているバイト範囲を取得します。

pcRangesDWORD*outppRanges 配列で返される範囲の数を受け取ります。
ppRangesMF_BYTE_STREAM_CACHE_RANGE**outMF_BYTE_STREAM_CACHE_RANGE 構造体の配列を受け取ります。各構造体は、キャッシュに格納されたバイト範囲を指定します。呼び出し元は、CoTaskMemFree を呼び出して配列を解放する必要があります。

戻り値

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

vtbl 5 HRESULT SetCacheLimit(ULONGLONG qwBytes)

キャッシュサイズを制限します。

qwBytesULONGLONGinキャッシュに格納する最大バイト数、または制限なしを表す ULONGLONG_MAX 。既定値は制限なしです。

戻り値

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

vtbl 6 HRESULT IsBackgroundTransferActive(BOOL* pfActive)

バックグラウンド転送がアクティブかどうかを照会します。

pfActiveBOOL*outバックグラウンド転送が現在アクティブな場合は TRUE、それ以外の場合は FALSE を受け取ります。

戻り値

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

解説(Remarks)

バックグラウンド転送は、キャッシュの上限に達した場合（IMFByteStreamCacheControl2::SetCacheLimit を参照）、または IMFByteStreamCacheControl::StopBackgroundTransfer メソッドが呼び出された場合に停止することがあります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IMFByteStreamCacheControl2 "{71CE469C-F34B-49EA-A56B-2D2A10E51149}"
#usecom global IMFByteStreamCacheControl2 IID_IMFByteStreamCacheControl2 "{}"
#comfunc global IMFByteStreamCacheControl2_GetByteRanges               4 var,var
#comfunc global IMFByteStreamCacheControl2_SetCacheLimit               5 int64
#comfunc global IMFByteStreamCacheControl2_IsBackgroundTransferActive  6 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。