structure KSPROPERTY_DESCRIPTION (ks.h)

Article
02/27/2024

La structure KSPROPERTY_DESCRIPTION spécifie la taille et le type de valeurs contenues dans une propriété spécifique.

Syntaxe

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

Membres

AccessFlags

Spécifie l’accès autorisé à cette propriété. Une demande de prise en charge de base définit ce membre au niveau du bit OR des indicateurs pour tous les types d’accès pris en charge par le gestionnaire pour cette propriété. Pour obtenir la liste des valeurs d’indicateur possibles, consultez KSPROPERTY.

DescriptionSize

Spécifie la taille totale en octets de la structure KSPROPERTY_DESCRIPTION et toutes les entrées de valeurs qui la suivent. Si la demande de propriété de prise en charge de base ne retourne aucune entrée de valeur, ce membre correspond à la taille de KSPROPERTY_DESCRIPTION.

PropTypeSet

Structure de type KSIDENTIFIER. S’il est pris en charge par la propriété spécifique, spécifie le type de valeurs contenues dans cette propriété. Ce groupe est spécifié de manière unique par un GUID, de sorte que de nouveaux types de valeurs peuvent être créés sans chevaucher les extensions de cet ensemble. Les types de valeurs indiquent le type de la valeur (comme VT_BOOL, VT_UI4 dans l’ensemble standard). Il s’agit GUID_NULL, avec un identificateur de zéro, si les informations de valeurs ne sont pas prises en charge par cette propriété.

MembersListCount

Spécifie le nombre de structures KSPROPERTY_MEMBERSHEADER à suivre cet en-tête.

Reserved

Réservé pour un usage futur. Définit la valeur zéro.

Remarques

Un pilote retourne la structure KSPROPERTY_DESCRIPTION en réponse à une demande de propriété de support de base d’un client.

Le type de valeurs de propriété défini est spécifié par une structure KSIDENTIFIER . L’ensemble de base pris en charge est KSPROPSETID_General. Les identificateurs au sein de ce jeu sont les types VARENUM standard utilisés pour OLE.

Les informations sur les valeurs qui peuvent suivre la structure KSPROPERTY_DESCRIPTION sont décrites par une liste de structures KSPROPERTY_MEMBERSLIST , chacune contenant des informations de plage de données.

Pour plus d’informations, consultez Propriétés KS.