Partager via


KSPROPERTY_VALUES structure (ks.h)

La structure KSPROPERTY_VALUES décrit le type et les valeurs par défaut acceptables d’une propriété.

Syntaxe

typedef struct {
  KSIDENTIFIER                 PropTypeSet;
  ULONG                        MembersListCount;
  const KSPROPERTY_MEMBERSLIST *MembersList;
} KSPROPERTY_VALUES, *PKSPROPERTY_VALUES;

Membres

PropTypeSet

Spécifie une structure KSIDENTIFIER (voir KSEVENT) qui identifie le type de données de la propriété. Le membre Set d’une structure KSIDENTIFIER indique le jeu de types valeur pris en charge, et le membre Id de la même structure identifie le type dans le jeu.

MembersListCount

Spécifie le nombre d’entrées dans le tableau pointé par MembersList.

MembersList

Pointe vers un tableau de structures KSPROPERTY_MEMBERSLIST . Chaque entrée spécifie une liste de valeurs possibles ou d’ensembles de valeurs que la propriété peut supposer.

Remarques

PropTypeSet.Set est presque toujours égal KSPROPTYPESETID_General. Les types valeur individuels dans KSPROPTYPESETID_General correspondent aux types d’énumération VARENUM .

Les valeurs possibles pour PropTypeSet.Id dans les médias de streaming (audio/caméra) sont les suivantes :

Valeur Type de données
VT_BLOB Octets avec préfixe de longueur.
VT_BOOL Valeur booléenne. True a la valeur -1 et false a la valeur 0.
VT_CLSID ID de classe.
VT_I4 Entier de 4 octets.
VT_ILLEGAL Valeur non conforme.
VT_LPWSTR Chaîne à fin null large.
VT_R8 Un réel de 8 octets.
VT_UI1 Caractère non signé.
VT_UI2 Un short non signé.
VT_UI4 Entier non signé sur 4 octets.
VT_UI8 Entier non signé sur 8 octets.

Pour plus d’informations, consultez l’énumération VARENUM .

Un pilote peut spécifier un pointeur vers une structure KSPROPERTY_VALUES dans le KSPROPERTY_ITEM approprié pour une propriété.

Pour plus d’informations, consultez Propriétés KS.

Configuration requise

Condition requise Valeur
En-tête ks.h (inclure Ks.h)

Voir aussi

KSEVENT

KSPROPERTY_DESCRIPTION

KSPROPERTY_ITEM

KSPROPERTY_MEMBERSLIST

VARENUM