KSPROPERTY_VALUES structure (ks.h)

Article
02/29/2024

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.