KsRegisterFilterWithNoKSPins 関数 (ks.h)

KsRegisterFilterWithNoKSPins 関数は、カーネル ストリーミング ピンを持たない DirectShow フィルターに登録されるため、カーネル モードではストリーミングされません。

構文

KSDDKAPI NTSTATUS KsRegisterFilterWithNoKSPins(
  [in]           PDEVICE_OBJECT DeviceObject,
  [in]           const GUID     *InterfaceClassGUID,
  [in]           ULONG          PinCount,
  [in]           BOOL           *PinDirection,
  [in]           KSPIN_MEDIUM   *MediumList,
  [in, optional] GUID           *CategoryList
);

パラメーター

[in] DeviceObject

フィルターを登録するデバイスに対応する DEVICE_OBJECT 構造体へのポインター。

[in] InterfaceClassGUID

登録するクラスを表す GUID へのポインター。 たとえば、これは TvTuner フィルターのKSCATEGORY_TVTUNERを指します。

[in] PinCount

フィルター上のピンの数。

[in] PinDirection

フィルター上の各ピンのピンの方向を示すブール値の配列の最初の要素へのポインター。 出力ピンは TRUE です。入力ピンは FALSE です。 この配列の長さは PinCount である必要があります。

[in] MediumList

フィルター上の各ピンのメディアを定義する KSPIN_MEDIUM 構造体の配列の最初の要素へのポインター。 この配列の長さは PinCount である必要があります。

[in, optional] CategoryList

フィルター上の各ピンのカテゴリを定義する GUID の配列の最初の要素へのポインター。 このパラメーターが存在する場合は、 長さが PinCount である必要があります。

戻り値

レジストリで FilterData キーを作成した場合の成功または失敗を返します。

注釈

KsRegisterFilterWithNoKSPins を使用して、TvTuners、Crossbars、および同様のコンポーネントを登録します。 KsRegisterFilterWithNoKSPins は、フィルター上の各ピンに対して、メディアと必要に応じてカテゴリを含む新しいレジストリ キー FilterData を作成します。

この関数は、対応するカーネル ピンがないフィルターを登録するためにのみ使用されます。 成功した場合、 KsRegisterFilterWithNoKSPins は、DirectShow で使用できるキーをレジストリに作成します。

BDA ミニドライバーを記述する場合は、このルーチンの代わりに KsFilterFactoryUpdateCacheData を使用することを検討してください。 KsFilterFactoryUpdateCacheData のリファレンス ページの詳細を参照してください。

詳細については、「 AVStream 記述子 」および「 AVStream ミニドライバーの初期化」を参照してください。

要件

こちらもご覧ください

DEVICE_OBJECT

DRIVER_OBJECT

KsFilterFactoryUpdateCacheData

KsFilterRegisterPowerCallbacks