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的 [旗標] 字段已設定KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID旗標。

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

規格需求