estructura KSPROPERTY_MEMBERSHEADER (ks.h)

Artículo
02/26/2024

Un controlador proporciona una estructura de tipo KSPROPERTY_MEMBERSHEADER para describir el tamaño y el tipo de cada elemento de una matriz que contiene valores de propiedad o intervalos.

Sintaxis

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

Miembros

MembersFlags

Especifica el tipo de entradas de la lista de miembros. El tamaño de los valores válidos viene determinado por tipo de valor, tal y como se especifica en el miembro PropTypeSet de la estructura KSPROPERTY_DESCRIPTION . El número de pares de intervalo viene determinado por MembersCount. Debe ser uno de los valores enumerados en la tabla siguiente.

Valor	Descripción
KSPROPERTY_MEMBER_RANGES	Indica que los miembros de lista son intervalos, de tipo KSPROPERTY_BOUNDS_LONG o KSPROPERTY_BOUNDS_LONGLONG.
KSPROPERTY_MEMBER_STEPPEDRANGES	Indica que los siguientes miembros son valores escalonados dentro de intervalos, de tipo KSPROPERTY_STEPPING_LONG o KSPROPERTY_STEPPING_LONGLONG.
KSPROPERTY_MEMBER_VALUES	Cada entrada de la matriz de miembros es un valor único.

MembersSize

Especifica el tamaño, en bytes, de un elemento de matriz individual.

MembersCount

Especifica el número de entradas de la matriz de miembros.

Flags

Valor	Descripción
KSPROPERTY_MEMBER_RANGES	Indica que los miembros de lista son intervalos, de tipo KSPROPERTY_BOUNDS_LONG o KSPROPERTY_BOUNDS_LONGLONG.
KSPROPERTY_MEMBER_STEPPEDRANGES	Indica que los miembros siguientes son valores escalonados dentro de intervalos, de tipo KSPROPERTY_STEPPING_LONG o KSPROPERTY_STEPPING_LONGLONG.
KSPROPERTY_MEMBER_VALUES	Cada entrada de la matriz de miembros es un valor único.

Comentarios

El tamaño de la matriz se puede determinar multiplicando MembersCount por MembersSize.

Una estructura KSPROPERTY_MEMBERSLIST contiene una estructura KSPROPERTY_MEMBERSHEADER como primer miembro. El segundo miembro, Members, apunta a una matriz de valores de propiedad o intervalos.

Además, una estructura de KSPROPERTY_DESCRIPTION puede seguir una lista de estructuras de KSPROPERTY_MEMBERSHEADER.

Para obtener más información sobre KSPROPERTY_MEMBER_FLAG_DEFAULT, consulte KSPROPERTY_ITEM. Para obtener más información sobre KSPROPERTY_MEMBER_FLAG_BASICSUPPORT_MULTICHANNEL y KSPROPERTY_MEMBER_FLAG_BASICSUPPORT_UNIFORM, consulta Exponer nodos multicanal en la documentación de Audio del Kit de controladores de Windows (WDK).