KsInitializeDeviceProfile 函式 （ks.h）

KsInitializeDeviceProfile API 必須由所有迷你埠驅動程式呼叫，才能初始化配置檔存放區併發佈裝置配置檔。

語法

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

參數

[in] FilterFactory

這是相機驅動程式所建立的 KSFILTERFACTORY，可唯一識別相機的篩選處理站。

傳回值

如果提供的 KSFILTERFACTORY 不包含與 KSCATEGORY_VIDEO_CAMERA相關聯的裝置介面，則此 API 呼叫將會失敗，且 STATUS_INVALID_PARAMETER。

言論

必須設定 KSFILTERFACTORY 具有此篩選類型唯一 GUID 之 KSFILTER_DESCRIPTOR 結構的 ReferenceGuid 字段。 而且 KSFILTER_DESCRIPTOR 的 [旗標] 字段已設定 KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID 旗標。

若要從與這個 KSFILTERFACTORY裝置介面相關聯的配置檔存放區中刪除所有設定檔，驅動程式可能會呼叫 KsInitializeDeviceProfile 緊接著 KsPersistDeviceProfile。 這會導致空的配置檔資訊，這會從配置檔存放區中移除配置檔資訊。

要求

要求	價值
目標平臺	普遍
標頭	ks.h （包括 Ksmedia.h）
連結庫	Ks.lib