Partager via


KsPublishDeviceProfile, fonction (ks.h)

L’API KsPublishDeviceProfile est appelée pour publier des informations de profil d’appareil.

Syntaxe

KSDDKAPI NTSTATUS KsPublishDeviceProfile(
  [in] PKSFILTERFACTORY       FilterFactory,
  [in] PKSDEVICE_PROFILE_INFO Profile
);

Paramètres

[in] FilterFactory

Il s’agit du même KSFILTERFACTORY que celui utilisé dans l’API KsInitializeDeviceProfile .

[in] Profile

Il s’agit d’un profil de caméra de type KSDEVICE_PROFILE_INFO.

Valeur retournée

Les informations de profil de l’appareil photo ne sont associées qu’à la catégorie d’interface KSCATEGORY_VIDEO_CAMERA . Toute fabrique de filtre créée sans cette catégorie d’interface et la tentative d’enregistrement d’un profil de caméra entraîne le retour d’une STATUS_INVALID_PARAMETER par cette API.

Remarques

Cette API sera appelée à plusieurs reprises pour chaque profil pris en charge par le pilote de caméra. Chaque appel peut avoir un ensemble différent d’informations sur la concurrence et la plage de données. Le champ ProfileId du KSCAMERA_PROFILE_INFO doit être unique. Si le même ProfileId est utilisé et que le contenu des informations de profil est différent, l’appel suivant remplace les informations de profil antérieures.

Configuration requise

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