KsInitializeDeviceProfile, fonction (ks.h)

L’API KsInitializeDeviceProfile doit être appelée par tous les pilotes miniport pour initialiser le magasin de profils et publier les profils d’appareil.

Syntaxe

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

Paramètres

[in] FilterFactory

Il s’agit du KSFILTERFACTORY qui a été créé par le pilote de caméra pour identifier de manière unique la fabrique de filtre de l’appareil photo.

Valeur retournée

Si le KSFILTERFACTORY fourni ne contient pas d’interface d’appareil associée au KSCATEGORY_VIDEO_CAMERA, cet appel d’API échoue avec STATUS_INVALID_PARAMETER.

Remarques

Il est nécessaire que le champ ReferenceGuid de la structure KSFILTER_DESCRIPTOR contenue dans KSFILTERFACTORY soit défini avec un GUID unique pour ce type de filtre. Et le champ Indicateurs du KSFILTER_DESCRIPTOR a l’indicateur KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID défini.

Pour supprimer tous les profils du magasin de profils associé à l’interface de périphérique pour ce KSFILTERFACTORY, le pilote peut appeler KsInitializeDeviceProfile suivi immédiatement de KsPersistDeviceProfile. Cela entraînerait des informations de profil vides, ce qui supprimerait les informations de profil du magasin de profils.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ks.h (inclure Ksmedia.h)
Bibliothèque	Ks.lib