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

IAsyncReader

COM
IID56a868aa-0ad4-11ce-b03a-0020af0ba770継承元IUnknown自前メソッド開始 vtbl3

メソッド 8

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

vtbl 3 HRESULT RequestAllocator(IMemAllocator* pPreferred, ALLOCATOR_PROPERTIES* pProps, IMemAllocator** ppActual)
pPreferredIMemAllocator*in優先して使いたいアロケータを指定する。NULL可。
pPropsALLOCATOR_PROPERTIES*in要求するアロケータ要件(ALLOCATOR_PROPERTIES)を指定する。
ppActualIMemAllocator**out実際に使用するアロケータを受け取る出力先。
vtbl 4 HRESULT Request(IMediaSample* pSample, UINT_PTR dwUser)
pSampleIMediaSample*in読み取り先バッファを保持するメディアサンプルを指定する。時刻範囲で読取位置を表す。
dwUserUINT_PTRin要求を識別するためのユーザ定義値。WaitForNextで返る。
vtbl 5 HRESULT WaitForNext(DWORD dwTimeout, IMediaSample** ppSample, UINT_PTR* pdwUser)
dwTimeoutDWORDin完了待ちの最大時間(ミリ秒)。INFINITEで無期限待機する。
ppSampleIMediaSample**outoptional完了したメディアサンプルを受け取る出力先。
pdwUserUINT_PTR*outRequestで渡したユーザ定義値を受け取る出力先。
vtbl 6 HRESULT SyncReadAligned(IMediaSample* pSample)
pSampleIMediaSample*inアラインメント条件に従い同期読み取りするメディアサンプルを指定する。
vtbl 7 HRESULT SyncRead(LONGLONG llPosition, INT lLength, BYTE* pBuffer)
llPositionLONGLONGin読み取りを開始するバイト位置(オフセット)。
lLengthINTin読み取るバイト数。
pBufferBYTE*out読み取ったデータを格納するバッファへのポインタ。
vtbl 8 HRESULT Length(LONGLONG* pTotal, LONGLONG* pAvailable)
pTotalLONGLONG*outストリーム全体の長さ(バイト数)を受け取る出力先。
pAvailableLONGLONG*out現時点で読み取り可能な長さ(バイト数)を受け取る出力先。
vtbl 9 HRESULT BeginFlush()
vtbl 10 HRESULT EndFlush()

HSP用 COM定義

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

出力引数:
#define global IID_IAsyncReader "{56A868AA-0AD4-11CE-B03A-0020AF0BA770}"
#usecom global IAsyncReader IID_IAsyncReader "{}"
#comfunc global IAsyncReader_RequestAllocator  3 sptr,var,sptr
#comfunc global IAsyncReader_Request           4 sptr,sptr
#comfunc global IAsyncReader_WaitForNext       5 int,sptr,var
#comfunc global IAsyncReader_SyncReadAligned   6 sptr
#comfunc global IAsyncReader_SyncRead          7 int64,int,var
#comfunc global IAsyncReader_Length            8 var,var
#comfunc global IAsyncReader_BeginFlush        9
#comfunc global IAsyncReader_EndFlush          10
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。