KSPROPERTY_MEMBERSHEADER structure (ks.h)

Un pilote fournit une structure de type KSPROPERTY_MEMBERSHEADER pour décrire la taille et le type de chaque élément d’un tableau contenant des valeurs de propriété ou des plages.

Syntaxe

typedef struct {
  ULONG MembersFlags;
  ULONG MembersSize;
  ULONG MembersCount;
  ULONG Flags;
} KSPROPERTY_MEMBERSHEADER, *PKSPROPERTY_MEMBERSHEADER;

Membres

MembersFlags

Spécifie le type d’entrées dans la liste des membres. La taille des valeurs valides est déterminée par le type de valeur, comme spécifié dans le membre PropTypeSet de la structure KSPROPERTY_DESCRIPTION . Le nombre de paires de plages est déterminé par MembersCount. Il doit s’agir de l’une des valeurs répertoriées dans le tableau suivant.

Valeur Description
KSPROPERTY_MEMBER_RANGES Indique que les membres de liste sont des plages, de type KSPROPERTY_BOUNDS_LONG ou KSPROPERTY_BOUNDS_LONGLONG.
KSPROPERTY_MEMBER_STEPPEDRANGES Indique que les membres suivants sont des valeurs pas à pas dans des plages, de type KSPROPERTY_STEPPING_LONG ou KSPROPERTY_STEPPING_LONGLONG.
KSPROPERTY_MEMBER_VALUES Chaque entrée du tableau des membres est une valeur unique.

MembersSize

Spécifie la taille, en octets, d’un élément de tableau individuel.

MembersCount

Spécifie le nombre d’entrées dans le tableau de membres.

Flags

Spécifie le type d’entrées dans la liste des membres. La taille des valeurs valides est déterminée par le type de valeur, comme spécifié dans le membre PropTypeSet de la structure KSPROPERTY_DESCRIPTION . Le nombre de paires de plages est déterminé par MembersCount. Il doit s’agir de l’une des valeurs répertoriées dans le tableau suivant.

Valeur Description
KSPROPERTY_MEMBER_RANGES Indique que les membres de liste sont des plages, de type KSPROPERTY_BOUNDS_LONG ou KSPROPERTY_BOUNDS_LONGLONG.
KSPROPERTY_MEMBER_STEPPEDRANGES Indique que les membres suivants sont des valeurs pas à pas dans des plages, de type KSPROPERTY_STEPPING_LONG ou KSPROPERTY_STEPPING_LONGLONG.
KSPROPERTY_MEMBER_VALUES Chaque entrée du tableau des membres est une valeur unique.

Remarques

La taille du tableau peut être déterminée en multipliant MembersCount par MembersSize.

Une structure KSPROPERTY_MEMBERSLIST contient une structure KSPROPERTY_MEMBERSHEADER comme premier membre. Le deuxième membre, Membres, pointe vers un tableau de valeurs de propriété ou de plages.

En outre, une structure KSPROPERTY_DESCRIPTION peut être suivie d’une liste de structures KSPROPERTY_MEMBERSHEADER.

Pour plus d’informations sur KSPROPERTY_MEMBER_FLAG_DEFAULT, consultez KSPROPERTY_ITEM. Pour plus d’informations sur les KSPROPERTY_MEMBER_FLAG_BASICSUPPORT_MULTICHANNEL et les KSPROPERTY_MEMBER_FLAG_BASICSUPPORT_UNIFORM, consultez Exposition de nœuds multicanaux dans la documentation audio du Kit de pilotes Windows (WDK).

Configuration requise

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

Voir aussi

KSPROPERTY_BOUNDS_LONG

KSPROPERTY_BOUNDS_LONGLONG

KSPROPERTY_DESCRIPTION

KSPROPERTY_ITEM

KSPROPERTY_MEMBERSLIST

KSPROPERTY_STEPPING_LONG

KSPROPERTY_STEPPING_LONGLONG