ホーム › Media.WindowsMediaFormat › IWMWriterPreprocess

IWMWriterPreprocess

COM

📘 Microsoft Learn (日本語) · English

IIDfc54a285-38c4-45b5-aa23-85b9f7cb424b継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IWMWriterPreprocess インターフェイスはマルチパスエンコードを処理します。

メソッド 5

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

vtbl 3 HRESULT GetMaxPreprocessingPasses(DWORD dwInputNum, DWORD dwFlags, DWORD* pdwMaxNumPasses)

GetMaxPreprocessingPasses メソッドは、指定した入力ストリームに対する前処理パスの最大数を取得します。

dwInputNum	DWORD	in	DWORD。前処理パスの最大数を取得したい入力番号を格納します。
dwFlags	DWORD	in	予約済み。ゼロを設定します。
pdwMaxNumPasses	DWORD*	out	前処理パスの最大数を受け取る DWORD へのポインター。コーデックが 2 パスエンコードをサポートしている場合、最終パスはカウントされないため、この値は 1 になります。

戻り値

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。

Return code	Description
S_OK	メソッドは成功しました。
E_POINTER	pdwMaxNumPasses が NULL です。
E_INVALIDARG	dwInputNum が無効な入力ストリーム番号を指定しています。
NS_E_INVALID_REQUEST	ライターが実行されていません。

解説(Remarks)

指定した入力に対して前処理がサポートされていない場合、戻り時に pdwMaxNumPasses にはゼロが格納されます。

vtbl 4 HRESULT SetNumPreprocessingPasses(DWORD dwInputNum, DWORD dwFlags, DWORD dwNumPasses)

SetNumPreprocessingPasses メソッドは、入力に対して実行するパスの数を設定します。

dwInputNum	DWORD	in	DWORD。パスの数を設定したい入力番号を格納します。
dwFlags	DWORD	in	予約済み。ゼロを設定します。
dwNumPasses	DWORD	in	DWORD。前処理パスの数を格納します。

戻り値

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。

Return code

Description

S_OK

メソッドは成功しました。

E_INVALIDARG

dwNumPasses がゼロです。

または

dwInputNum が無効な入力ストリームを指定しています。

または

dwNumPasses が、指定した入力に対して許可されているパスの最大数を超えています。

NS_E_INVALID_REQUEST

ライターが実行されていません。

または

プリプロセッサは既に構成されています。

vtbl 5 HRESULT BeginPreprocessingPass(DWORD dwInputNum, DWORD dwFlags)

BeginPreprocessingPass メソッドは、指定した入力ストリームのサンプルの前処理を開始できるようライターを準備します。

dwInputNum	DWORD	in	DWORD。前処理したい入力番号を格納します。
dwFlags	DWORD	in	予約済み。ゼロを設定します。

戻り値

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。

Return code

Description

S_OK

メソッドは成功しました。

E_INVALIDARG

dwInputNum が無効な入力番号を指定しています。

NS_E_INVALID_REQUEST

ライターが実行されていません。

または

プリプロセッサが、実行待ちでもパスの途中で停止した状態でもありません。

または

プリプロセッサは既に SetNumPreprocessingPasses で指定された数だけパスを実行しています。

または

指定された入力は前処理をサポートしていません。

解説(Remarks)

BeginPreprocessingPass を正常に呼び出すには、SetNumPreprocessingPasses の呼び出しによってプリプロセッサが少なくとも 1 回の前処理パスを実行するよう設定されている必要があります。

このメソッドを呼び出す前に、IWMWriter::BeginWriting を呼び出してライターをアクティブ化しておく必要があります。

vtbl 6 HRESULT PreprocessSample(DWORD dwInputNum, ULONGLONG cnsSampleTime, DWORD dwFlags, INSSBuffer* pSample)

PreprocessSample メソッドは、前処理のためにサンプルをライターに渡します。

dwInputNum	DWORD	in	DWORD。サンプルの入力番号を格納します。
cnsSampleTime	ULONGLONG	in	サンプルのプレゼンテーション時間を 100 ナノ秒単位で指定します。
dwFlags	DWORD	in	予約済み。ゼロを設定します。
pSample	INSSBuffer*	in	サンプルを格納しているオブジェクトの INSSBuffer インターフェイスへのポインター。

戻り値

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。

Return code

Description

S_OK

メソッドは成功しました。

E_INVALIDARG

dwInputNum が無効な入力ストリームを指定しています。

または

pSample が NULL です。

NS_E_INVALID_REQUEST

ライターが実行されていません。

または

プリプロセッサが、実行待ちでもパスの途中で停止した状態でもありません。

または

プリプロセッサは既に SetNumPreprocessingPasses で指定された数だけパスを実行しています。

または

指定された入力は前処理をサポートしていません。

解説(Remarks)

前処理を実行する際は、ストリームのサンプルを 1 つずつこのメソッドに渡す必要があります。

vtbl 7 HRESULT EndPreprocessingPass(DWORD dwInputNum, DWORD dwFlags)

EndPreprocessingPass メソッドは、IWMWriterPreprocess::BeginPreprocessingPass の呼び出しによって開始された前処理パスを終了します。

dwInputNum	DWORD	in	DWORD。前処理を停止したい入力番号を格納します。
dwFlags	DWORD	in	予約済み。ゼロを設定します。

戻り値

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。

Return code	Description
S_OK	メソッドは成功しました。
E_INVALIDARG	dwInputNum が無効な入力番号を指定しています。
NS_E_INVALID_REQUEST	ライターが実行されていません。または指定したストリームに対してプリプロセッサが開始されていません。
E_FAIL	前処理パスの終了中にエラーが発生しました。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IWMWriterPreprocess "{FC54A285-38C4-45B5-AA23-85B9F7CB424B}"
#usecom global IWMWriterPreprocess IID_IWMWriterPreprocess "{}"
#comfunc global IWMWriterPreprocess_GetMaxPreprocessingPasses  3 int,int,var
#comfunc global IWMWriterPreprocess_SetNumPreprocessingPasses  4 int,int,int
#comfunc global IWMWriterPreprocess_BeginPreprocessingPass     5 int,int
#comfunc global IWMWriterPreprocess_PreprocessSample           6 int,int64,int,sptr
#comfunc global IWMWriterPreprocess_EndPreprocessingPass       7 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IWMWriterPreprocess "{FC54A285-38C4-45B5-AA23-85B9F7CB424B}"
#usecom global IWMWriterPreprocess IID_IWMWriterPreprocess "{}"
#comfunc global IWMWriterPreprocess_GetMaxPreprocessingPasses  3 int,int,sptr
#comfunc global IWMWriterPreprocess_SetNumPreprocessingPasses  4 int,int,int
#comfunc global IWMWriterPreprocess_BeginPreprocessingPass     5 int,int
#comfunc global IWMWriterPreprocess_PreprocessSample           6 int,int64,int,sptr
#comfunc global IWMWriterPreprocess_EndPreprocessingPass       7 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。