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 de la KSFILTERFACTORY créée par le pilote de caméra pour identifier de manière unique la fabrique de filtre de la caméra.

Valeur de retour

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 avec le KSFILTERFACTORY être défini avec un GUID unique pour ce type de filtre. Et le champ indicateurs de 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 l’appareil pour cette KSFILTERFACTORY, le pilote peut appeler KsInitializeDeviceProfile suivi immédiatement par KsPersistDeviceProfile. Cela entraînerait des informations de profil vides, ce qui supprimerait les informations de profil du magasin de profils.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ks.h (include Ksmedia.h)
bibliothèque	Ks.lib