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

IKsControl

COM
IID28f54685-06fd-11d2-b27a-00a0c9223196継承元IUnknown自前メソッド開始 vtbl3

メソッド 3

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

vtbl 3 HRESULT KsProperty(KSIDENTIFIER* Property, DWORD PropertyLength, void* PropertyData, DWORD DataLength, DWORD* BytesReturned)
PropertyKSIDENTIFIER*in対象プロパティを識別する KSIDENTIFIER(KSPROPERTY)へのポインタを指定する。
PropertyLengthDWORDinProperty 構造体のバイト数を指定する。
PropertyDatavoid*inoutプロパティ値の入出力に用いるバッファへのポインタを指定する。
DataLengthDWORDinPropertyData バッファのバイト数を指定する。
BytesReturnedDWORD*out実際に返されたバイト数を受け取る DWORD ポインタ。
vtbl 4 HRESULT KsMethod(KSIDENTIFIER* Method, DWORD MethodLength, void* MethodData, DWORD DataLength, DWORD* BytesReturned)
MethodKSIDENTIFIER*in実行するメソッドを識別する KSIDENTIFIER(KSMETHOD)へのポインタを指定する。
MethodLengthDWORDinMethod 構造体のバイト数を指定する。
MethodDatavoid*inoutメソッド引数や結果の入出力に用いるバッファへのポインタを指定する。
DataLengthDWORDinMethodData バッファのバイト数を指定する。
BytesReturnedDWORD*out実際に返されたバイト数を受け取る DWORD ポインタ。
vtbl 5 HRESULT KsEvent(KSIDENTIFIER* Event, DWORD EventLength, void* EventData, DWORD DataLength, DWORD* BytesReturned)
EventKSIDENTIFIER*in登録または解除するイベントを識別する KSIDENTIFIER(KSEVENT)へのポインタを指定する。解除時は NULL 可。
EventLengthDWORDinEvent 構造体のバイト数を指定する。
EventDatavoid*inoutイベント登録に伴うデータの入出力に用いるバッファへのポインタを指定する。
DataLengthDWORDinEventData バッファのバイト数を指定する。
BytesReturnedDWORD*out実際に返されたバイト数を受け取る DWORD ポインタ。

HSP用 COM定義

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

出力引数:
#define global IID_IKsControl "{28F54685-06FD-11D2-B27A-00A0C9223196}"
#usecom global IKsControl IID_IKsControl "{}"
#comfunc global IKsControl_KsProperty  3 var,int,sptr,int,var
#comfunc global IKsControl_KsMethod    4 var,int,sptr,int,var
#comfunc global IKsControl_KsEvent     5 var,int,sptr,int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。