KsInitializeDeviceProfile - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ks.h
KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
[in] PKSFILTERFACTORY FilterFactory
);
View the official Windows Driver Kit DDI referenceNo description available.
The KsInitializeDeviceProfile API must be called by all miniport drivers to initialize the profile store and publish the device profiles.
FilterFactory [in]This is the KSFILTERFACTORY that was created by the camera driver to uniquely identify the camera’s filter factory.
If the provided KSFILTERFACTORY does not contain a device interface associated with the KSCATEGORY_VIDEO_CAMERA, this API call will fail with STATUS_INVALID_PARAMETER.
It is required that the ReferenceGuid field of the KSFILTER_DESCRIPTOR structure contained with the KSFILTERFACTORY be set with a unique GUID for this filter type. And the Flags field of the KSFILTER_DESCRIPTOR has the KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID flag set.
To delete all profiles from the profile store associated with the device interface for this KSFILTERFACTORY, the driver may call KsInitializeDeviceProfile followed immediately by KsPersistDeviceProfile. This would result in an empty profile information, which would remove the profile information from the profile store.