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

IMFSaveJob

COM
📘 Microsoft Learn (日本語) · English
IIDe9931663-80bf-4c6e-98af-5dcf58747d1f継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ソースのバイトストリームからメディアデータを、アプリケーションが提供するバイトストリームへ永続化します。

メソッド 4

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

vtbl 3 HRESULT BeginSave(IMFByteStream* pStream, IMFAsyncCallback* pCallback, IUnknown* pState)

Windows Media ファイルをアプリケーションのバイトストリームへ保存する処理を開始します。

pStreamIMFByteStream*inアプリケーションのバイトストリームの IMFByteStream インターフェイスへのポインター。ソースのバイトストリームのデータは、このバイトストリームに書き込まれます。
pCallbackIMFAsyncCallback*inコールバックオブジェクトの IMFAsyncCallback インターフェイスへのポインター。呼び出し元はこのインターフェイスを実装する必要があります。
pStateIUnknown*in呼び出し元が定義する状態オブジェクトの IUnknown インターフェイスへのポインター。このパラメーターは NULL でもかまいません。このオブジェクトを使用して状態情報を保持できます。オブジェクトは、コールバックが呼び出されるときに呼び出し元へ返されます。

戻り値

このメソッドは HRESULT を返します。使用可能な値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値 説明
S_OK
 メソッドは成功しました。

解説(Remarks)

処理が完了すると、コールバックオブジェクトの IMFAsyncCallback::Invoke メソッドが呼び出されます。その時点で、アプリケーションは IMFSaveJob::EndSave を呼び出して非同期要求を完了する必要があります。

vtbl 4 HRESULT EndSave(IMFAsyncResult* pResult)

IMFSaveJob::BeginSave によって開始された処理を完了します。

pResultIMFAsyncResult*inIMFAsyncResult インターフェイスへのポインター。コールバックオブジェクトが IMFAsyncCallback::Invoke メソッドで受け取ったものと同じポインターを渡します。

戻り値

このメソッドは HRESULT を返します。使用可能な値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値 説明
S_OK
 メソッドは成功しました。
vtbl 5 HRESULT CancelSave()

IMFSaveJob::BeginSave によって開始された処理をキャンセルします。

戻り値

このメソッドは HRESULT を返します。使用可能な値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値 説明
S_OK
 メソッドは成功しました。
vtbl 6 HRESULT GetProgress(DWORD* pdwPercentComplete)

指定したバイトストリームへ保存されたコンテンツの割合(パーセント)を取得します。

pdwPercentCompleteDWORD*out完了率(パーセント)を受け取ります。

戻り値

このメソッドは HRESULT を返します。使用可能な値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値 説明
S_OK
 メソッドは成功しました。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMFSaveJob "{E9931663-80BF-4C6E-98AF-5DCF58747D1F}"
#usecom global IMFSaveJob IID_IMFSaveJob "{}"
#comfunc global IMFSaveJob_BeginSave    3 sptr,sptr,sptr
#comfunc global IMFSaveJob_EndSave      4 sptr
#comfunc global IMFSaveJob_CancelSave   5
#comfunc global IMFSaveJob_GetProgress  6 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。