KSPROPERTY_MEMBERSHEADER struttura (ks.h)

Articolo
02/26/2024

Un driver fornisce una struttura di tipo KSPROPERTY_MEMBERSHEADER per descrivere le dimensioni e il tipo di ogni elemento in una matrice contenente valori di proprietà o intervalli.

Sintassi

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

Members

MembersFlags

Specifica il tipo di voci nell'elenco dei membri. Le dimensioni dei valori validi sono determinate dal tipo di valore, come specificato nel membro PropTypeSet della struttura KSPROPERTY_DESCRIPTION . Il numero di coppie di intervallo è determinato da MembersCount. Questo valore deve essere uno dei valori elencati nella tabella seguente.

Valore	Descrizione
KSPROPERTY_MEMBER_RANGES	Indica che i membri dell'elenco sono intervalli, di tipo KSPROPERTY_BOUNDS_LONG o KSPROPERTY_BOUNDS_LONGLONG.
KSPROPERTY_MEMBER_STEPPEDRANGES	Indica che i membri seguenti vengono troncato all'interno di intervalli, di tipo KSPROPERTY_STEPPING_LONG o KSPROPERTY_STEPPING_LONGLONG.
KSPROPERTY_MEMBER_VALUES	Ogni voce nella matrice dei membri è un singolo valore.

MembersSize

Specifica le dimensioni, in byte, di un singolo elemento di matrice.

MembersCount

Specifica il numero di voci nella matrice dei membri.

Flags

Valore	Descrizione
KSPROPERTY_MEMBER_RANGES	Indica che i membri dell'elenco sono intervalli, di tipo KSPROPERTY_BOUNDS_LONG o KSPROPERTY_BOUNDS_LONGLONG.
KSPROPERTY_MEMBER_STEPPEDRANGES	Indica che i membri seguenti vengono rientri all'interno di intervalli, di tipo KSPROPERTY_STEPPING_LONG o KSPROPERTY_STEPPING_LONGLONG.
KSPROPERTY_MEMBER_VALUES	Ogni voce nella matrice dei membri è un singolo valore.

Commenti

Le dimensioni della matrice possono essere determinate moltiplicando MembersCount per MembersSize.

Una struttura KSPROPERTY_MEMBERSLIST contiene una struttura KSPROPERTY_MEMBERSHEADER come primo membro. Il secondo membro, Membri, punta a una matrice di valori o intervalli di proprietà.

Inoltre, una struttura KSPROPERTY_DESCRIPTION può essere seguita da un elenco di strutture KSPROPERTY_MEMBERSHEADER.

Per altre informazioni sulle KSPROPERTY_MEMBER_FLAG_DEFAULT, vedere KSPROPERTY_ITEM. Per altre informazioni su KSPROPERTY_MEMBER_FLAG_BASICSUPPORT_MULTICHANNEL e KSPROPERTY_MEMBER_FLAG_BASICSUPPORT_UNIFORM, vedere Esposizione di nodi multicanale nella documentazione di Windows Driver Kit (WDK).