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

IKsPin

COM
📘 Microsoft Learn (日本語) · English
IIDb61178d1-a2d9-11cf-9e53-00aa00a216a1継承元IUnknown自前メソッド開始 vtbl3

メソッド 13

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

vtbl 3 HRESULT KsQueryMediums(KSMULTIPLE_ITEM** MediumList)
MediumListKSMULTIPLE_ITEM**outピンがサポートするメディウム一覧を受け取る KSMULTIPLE_ITEM へのポインタの格納先。呼び出し側が解放する。
vtbl 4 HRESULT KsQueryInterfaces(KSMULTIPLE_ITEM** InterfaceList)
InterfaceListKSMULTIPLE_ITEM**outピンがサポートするインターフェイス一覧を受け取る KSMULTIPLE_ITEM へのポインタの格納先。呼び出し側が解放する。
vtbl 5 HRESULT KsCreateSinkPinHandle(KSIDENTIFIER* Interface, KSIDENTIFIER* Medium)
InterfaceKSIDENTIFIER*in確立するピンのインターフェイス識別子 KSIDENTIFIER へのポインタを指定する。
MediumKSIDENTIFIER*in確立するピンのメディウム識別子 KSIDENTIFIER へのポインタを指定する。
vtbl 6 HRESULT KsGetCurrentCommunication(KSPIN_COMMUNICATION* Communication, KSIDENTIFIER* Interface, KSIDENTIFIER* Medium)
CommunicationKSPIN_COMMUNICATION*outoptional現在のピンの通信方法を受け取る KSPIN_COMMUNICATION 列挙値ポインタ。NULL 可。
InterfaceKSIDENTIFIER*outoptional現在のインターフェイス識別子を受け取る KSIDENTIFIER ポインタ。NULL 可。
MediumKSIDENTIFIER*outoptional現在のメディウム識別子を受け取る KSIDENTIFIER ポインタ。NULL 可。
vtbl 7 HRESULT KsPropagateAcquire()
vtbl 8 HRESULT KsDeliver(IMediaSample* Sample, DWORD Flags)
SampleIMediaSample*in下流へ配送するデータを保持する IMediaSample へのポインタを指定する。
FlagsDWORDin配送動作を制御するフラグを指定する。
vtbl 9 HRESULT KsMediaSamplesCompleted(KSSTREAM_SEGMENT* StreamSegment)
StreamSegmentKSSTREAM_SEGMENT*in完了したサンプル群を表す KSSTREAM_SEGMENT 構造体へのポインタを指定する。
vtbl 10 IMemAllocator* KsPeekAllocator(KSPEEKOPERATION Operation)
OperationKSPEEKOPERATIONinアロケータの参照方法を指定する KSPEEKOPERATION 列挙値を指定する。所有権移転の有無を制御する。
vtbl 11 HRESULT KsReceiveAllocator(IMemAllocator* MemAllocator)
MemAllocatorIMemAllocator*inoptionalピンに設定するメモリアロケータ IMemAllocator へのポインタを指定する。NULL 可。
vtbl 12 HRESULT KsRenegotiateAllocator()
vtbl 13 INT KsIncrementPendingIoCount()
vtbl 14 INT KsDecrementPendingIoCount()
vtbl 15 HRESULT KsQualityNotify(DWORD Proportion, LONGLONG TimeDelta)
ProportionDWORDin品質を百分率(1000 = 100%)等の割合で表す値を指定する。
TimeDeltaLONGLONGin目標時刻に対する遅れ/進みを 100ns 単位で指定する。

HSP用 COM定義

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

出力引数: 
#define global IID_IKsPin "{B61178D1-A2D9-11CF-9E53-00AA00A216A1}"
#usecom global IKsPin IID_IKsPin "{}"
#comfunc global IKsPin_KsQueryMediums             3 var
#comfunc global IKsPin_KsQueryInterfaces          4 var
#comfunc global IKsPin_KsCreateSinkPinHandle      5 var,var
#comfunc global IKsPin_KsGetCurrentCommunication  6 var,var,var
#comfunc global IKsPin_KsPropagateAcquire         7
#comfunc global IKsPin_KsDeliver                  8 sptr,int
#comfunc global IKsPin_KsMediaSamplesCompleted    9 var
#comfunc global IKsPin_KsPeekAllocator            10 int
#comfunc global IKsPin_KsReceiveAllocator         11 sptr
#comfunc global IKsPin_KsRenegotiateAllocator     12
#comfunc global IKsPin_KsIncrementPendingIoCount  13
#comfunc global IKsPin_KsDecrementPendingIoCount  14
#comfunc global IKsPin_KsQualityNotify            15 int,int64
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。