structure KSPIN_DESCRIPTOR (ks.h)

Article
02/29/2024

La structure KSPIN_DESCRIPTOR décrit les propriétés KSPROPSETID_Pin de base d’un type de broche.

Syntaxe

typedef struct {
  ULONG                 InterfacesCount;
  const KSPIN_INTERFACE *Interfaces;
  ULONG                 MediumsCount;
  const KSPIN_MEDIUM    *Mediums;
  ULONG                 DataRangesCount;
  const PKSDATARANGE    *DataRanges;
  KSPIN_DATAFLOW        DataFlow;
  KSPIN_COMMUNICATION   Communication;
  const GUID            *Category;
  const GUID            *Name;
  union {
    LONGLONG Reserved;
    struct {
      ULONG        ConstrainedDataRangesCount;
      PKSDATARANGE *ConstrainedDataRanges;
    };
  };
} KSPIN_DESCRIPTOR, *PKSPIN_DESCRIPTOR;

Membres

InterfacesCount

Spécifie la taille du tableau pointé vers les interfaces.

Interfaces

Tableau de structures KSPIN_INTERFACE spécifiant les interfaces prises en charge par ce type de broche.

MediumsCount

Spécifie le nombre d’éléments dans le tableau pointé vers moyen.

Mediums

Tableau de structures KSPIN_MEDIUM spécifiant les supports pris en charge par ce type de broche.

DataRangesCount

Spécifie la taille du tableau pointé vers dataRanges.

DataRanges

Tableau de structures KSDATARANGE spécifiant les plages de données prises en charge par ce type de broche.

DataFlow

Spécifie KSPIN_DATAFLOW_IN ou KSPIN_DATAFLOW_OUT. Voir KSPROPERTY_PIN_DATAFLOW.

Communication

Spécifie KSPIN_COMMUNICATION_NONE, KSPIN_COMMUNICATION_SINK, KSPIN_COMMUNICATION_SOURCE, KSPIN_COMMUNICATION_BOTH ou KSPIN_COMMUNICATION_BRIDGE. Consultez KSPROPERTY_PIN_COMMUNICATION pour connaître la signification de chaque valeur.

Category

Spécifie un pointeur vers un GUID de catégorie de broche KS. Le GUID de catégorie de broche KS identifie la catégorie générale de fonctionnalités que la broche fournit. Des exemples de GUID de catégorie de brocheS KS sont KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES et KSNODETYPE_MICROPHONE, qui sont tous définis dans Ksmedia.h. Consultez également Pin Category Property.

Name

Spécifie le GUID du nom de chaîne Unicode localisé pour le type de broche, stocké dans le Registre.

Reserved

Non utilisé. Membre d’une union sans nom utilisée pour forcer un alignement correct sur la structure sans nom.

ConstrainedDataRangesCount

Spécifie le nombre d’entrées dans le tableau pointé vers par ConstrainedDataRanges.

ConstrainedDataRanges

Pointe vers un tableau de structures KSDATARANGE . Indique l’ensemble de plages de données que le type de broche prend actuellement en charge, en fonction de l’état interne du pilote.