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 を呼び出すことができます。 これにより、空のプロファイル情報が生成され、プロファイル ストアからプロファイル情報が削除されます。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	ks.h (Ksmedia.h を含む)
Library	Ks.lib