次の方法で共有

KsInitializeDeviceProfile 関数 (ks.h)

  • [アーティクル]

KsInitializeDeviceProfile API は、プロファイル ストアを初期化し、デバイス プロファイルを発行するために、すべてのミニポート ドライバーによって呼び出される必要があります。

構文

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

パラメーター

[in] FilterFactory

これは、カメラ のフィルター ファクトリを一意に識別するためにカメラ ドライバーによって作成された KSFILTERFACTORY です。

戻り値

指定された KSFILTERFACTORY に KSCATEGORY_VIDEO_CAMERAに関連付けられたデバイス インターフェイスが含まれていない場合、この API 呼び出しは STATUS_INVALID_PARAMETERで失敗します。

備考

KSFILTERFACTORY に含まれる KSFILTER_DESCRIPTOR 構造体の ReferenceGuid フィールドに、このフィルターの種類の一意の GUID を設定 必要があります。 また、KSFILTER_DESCRIPTOR の Flags フィールドには、KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID フラグが設定されています。

この KSFILTERFACTORYのデバイス インターフェイスに関連付けられているプロファイル ストアからすべてのプロファイルを削除するには、ドライバーは KsInitializeDeviceProfile を呼び出し、その直後に KsPersistDeviceProfile 呼び出します。 これにより、空のプロファイル情報が生成され、プロファイル ストアからプロファイル情報が削除されます。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー ks.h (Ksmedia.h を含む)
ライブラリ Ks.lib