struttura KSPROPERTY_DESCRIPTION (ks.h)

Articolo
02/07/2025

La struttura KSPROPERTY_DESCRIPTION specifica le dimensioni e il tipo di valori contenuti in una proprietà specifica.

Sintassi

typedef struct {
  ULONG        AccessFlags;
  ULONG        DescriptionSize;
  KSIDENTIFIER PropTypeSet;
  ULONG        MembersListCount;
  ULONG        Reserved;
} KSPROPERTY_DESCRIPTION, *PKSPROPERTY_DESCRIPTION;

Membri

AccessFlags

Specifica l'accesso consentito a questa proprietà. Una richiesta di supporto di base imposta questo membro sull'OR bit per bit dei flag per tutti i tipi di accesso supportati dal gestore per questa proprietà. Per un elenco dei possibili valori di flag, vedere KSPROPERTY.

DescriptionSize

Specifica le dimensioni totali in byte della struttura KSPROPERTY_DESCRIPTION e di eventuali voci di valori che lo seguono. Se la richiesta di proprietà di supporto di base non restituisce voci di valori, questo membro corrisponde alle dimensioni di KSPROPERTY_DESCRIPTION.

PropTypeSet

Struttura di tipo KSIDENTIFIER. Se supportato dalla proprietà specifica, specifica il tipo di valori contenuti in questa proprietà. Questo gruppo viene specificato in modo univoco da un GUID, in modo che i nuovi tipi di valori possano essere creati senza sovrapporsi con estensioni a questo set. I tipi valore indicano il tipo del valore , ad esempio VT_BOOL, VT_UI4 nel set standard. Si tratta di GUID_NULL, con un identificatore pari a zero, se le informazioni sui valori non sono supportate da questa proprietà.

MembersListCount

Specifica il numero di strutture KSPROPERTY_MEMBERSHEADER da seguire per questa intestazione.

Reserved

Riservato per uso futuro. Impostare su zero.

Osservazioni

Un driver restituisce la struttura KSPROPERTY_DESCRIPTION in risposta a una richiesta di proprietà di supporto di base da un client.

Il set di tipi di valori della proprietà viene specificato da una struttura KSIDENTIFIER. Il set di base supportato è KSPROPSETID_General. Gli identificatori all'interno di tale set sono i tipi VARENUM standard usati per OLE.

Le informazioni sui valori che possono seguire la struttura KSPROPERTY_DESCRIPTION sono descritte da un elenco di strutture KSPROPERTY_MEMBERSLIST, ognuna delle quali contiene informazioni sull'intervallo di dati.

Per altre informazioni, vedere proprietà KS.