ホーム › Media.KernelStreaming › IKsPin
IKsPin
COM公式ドキュメント
IKsPin インターフェイスは、カーネルモードフィルターのピンがサポートするメディア(medium)を取得するメソッドを提供します。IKsPin にはここに示すもの以外にもメソッドがありますが、DirectShow ではサポートされていません。
解説(Remarks)
[このページに関連する機能である DirectShow は、レガシー機能です。この機能は MediaPlayer、IMFMediaEngine、および Media Foundation でのオーディオ/ビデオキャプチャ に置き換えられています。これらの機能は Windows 10 および Windows 11 向けに最適化されています。Microsoft は、可能な場合は新しいコードで DirectShow の代わりに MediaPlayer、IMFMediaEngine、および Media Foundation でのオーディオ/ビデオキャプチャ を使用することを強く推奨します。Microsoft は、レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き直すことを推奨します。]
IKsPin インターフェイスは、カーネルモードフィルターのピンがサポートするメディア(medium)を取得するメソッドを提供します。IKsPin にはここに示すもの以外にもメソッドがありますが、DirectShow ではサポートされていません。
Ksproxy.h よりも前に Ks.h をインクルードする必要があります。
メソッド 13
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT KsQueryMediums(KSMULTIPLE_ITEM** MediumList)
ピンがサポートするメディア(medium)を取得します。
| MediumList | KSMULTIPLE_ITEM** | out | ピンがサポートするメディウム一覧を受け取る KSMULTIPLE_ITEM へのポインタの格納先。呼び出し側が解放する。 |
vtbl 4 HRESULT KsQueryInterfaces(KSMULTIPLE_ITEM** InterfaceList)
| InterfaceList | KSMULTIPLE_ITEM** | out | ピンがサポートするインターフェイス一覧を受け取る KSMULTIPLE_ITEM へのポインタの格納先。呼び出し側が解放する。 |
vtbl 5 HRESULT KsCreateSinkPinHandle(KSIDENTIFIER* Interface, KSIDENTIFIER* Medium)
| Interface | KSIDENTIFIER* | in | 確立するピンのインターフェイス識別子 KSIDENTIFIER へのポインタを指定する。 |
| Medium | KSIDENTIFIER* | in | 確立するピンのメディウム識別子 KSIDENTIFIER へのポインタを指定する。 |
vtbl 6 HRESULT KsGetCurrentCommunication(KSPIN_COMMUNICATION* Communication, KSIDENTIFIER* Interface, KSIDENTIFIER* Medium)
| Communication | KSPIN_COMMUNICATION* | outoptional | 現在のピンの通信方法を受け取る KSPIN_COMMUNICATION 列挙値ポインタ。NULL 可。 |
| Interface | KSIDENTIFIER* | outoptional | 現在のインターフェイス識別子を受け取る KSIDENTIFIER ポインタ。NULL 可。 |
| Medium | KSIDENTIFIER* | outoptional | 現在のメディウム識別子を受け取る KSIDENTIFIER ポインタ。NULL 可。 |
vtbl 7 HRESULT KsPropagateAcquire()
vtbl 8 HRESULT KsDeliver(IMediaSample* Sample, DWORD Flags)
| Sample | IMediaSample* | in | 下流へ配送するデータを保持する IMediaSample へのポインタを指定する。 |
| Flags | DWORD | in | 配送動作を制御するフラグを指定する。 |
vtbl 9 HRESULT KsMediaSamplesCompleted(KSSTREAM_SEGMENT* StreamSegment)
| StreamSegment | KSSTREAM_SEGMENT* | in | 完了したサンプル群を表す KSSTREAM_SEGMENT 構造体へのポインタを指定する。 |
vtbl 10 IMemAllocator* KsPeekAllocator(KSPEEKOPERATION Operation)
| Operation | KSPEEKOPERATION | in | アロケータの参照方法を指定する KSPEEKOPERATION 列挙値を指定する。所有権移転の有無を制御する。 |
vtbl 11 HRESULT KsReceiveAllocator(IMemAllocator* MemAllocator)
| MemAllocator | IMemAllocator* | inoptional | ピンに設定するメモリアロケータ IMemAllocator へのポインタを指定する。NULL 可。 |
vtbl 12 HRESULT KsRenegotiateAllocator()
vtbl 13 INT KsIncrementPendingIoCount()
vtbl 14 INT KsDecrementPendingIoCount()
| Proportion | DWORD | in | 品質を百分率(1000 = 100%)等の割合で表す値を指定する。 |
| TimeDelta | LONGLONG | in | 目標時刻に対する遅れ/進みを 100ns 単位で指定する。 |
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)
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 指定が可能。#define global IID_IKsPin "{B61178D1-A2D9-11CF-9E53-00AA00A216A1}" #usecom global IKsPin IID_IKsPin "{}" #comfunc global IKsPin_KsQueryMediums 3 sptr #comfunc global IKsPin_KsQueryInterfaces 4 sptr #comfunc global IKsPin_KsCreateSinkPinHandle 5 sptr,sptr #comfunc global IKsPin_KsGetCurrentCommunication 6 sptr,sptr,sptr #comfunc global IKsPin_KsPropagateAcquire 7 #comfunc global IKsPin_KsDeliver 8 sptr,int #comfunc global IKsPin_KsMediaSamplesCompleted 9 sptr #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が無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。