KSPIN_DESCRIPTOR struttura (ks.h)

Articolo
02/29/2024

La struttura KSPIN_DESCRIPTOR descrive le proprietà di base KSPROPSETID_Pin di un tipo di pin.

Sintassi

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;

Members

InterfacesCount

Specifica le dimensioni della matrice a cui punta da Interfacce.

Interfaces

Matrice di strutture KSPIN_INTERFACE che specificano le interfacce supportate da questo tipo di pin.

MediumsCount

Specifica il numero di elementi nella matrice a cui punta media.

Mediums

Matrice di strutture KSPIN_MEDIUM che specificano i supporti supportati da questo tipo di pin.

DataRangesCount

Specifica le dimensioni della matrice puntata da DataRanges.

DataRanges

Matrice di strutture KSDATARANGE che specificano gli intervalli di dati supportati da questo tipo di pin.

DataFlow

Specifica KSPIN_DATAFLOW_IN o KSPIN_DATAFLOW_OUT . Vedere KSPROPERTY_PIN_DATAFLOW.

Communication

Specifica KSPIN_COMMUNICATION_NONE, KSPIN_COMMUNICATION_SINK, KSPIN_COMMUNICATION_SOURCE, KSPIN_COMMUNICATION_BOTH o KSPIN_COMMUNICATION_BRIDGE. Vedere KSPROPERTY_PIN_COMMUNICATION per il significato di ogni valore.

Category

Specifica un puntatore a un GUID della categoria di pin KS. Il GUID della categoria pin KS identifica la categoria generale di funzionalità fornita dal pin. Esempi di GUID delle categorie di pin KS sono KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES e KSNODETYPE_MICROPHONE, che sono tutti definiti in Ksmedia.h. Vedere anche La proprietà Pin Category.

Name

Specifica il GUID del nome stringa Unicode localizzato per il tipo di pin archiviato nel Registro di sistema.

Reserved

Non usato. Membro di un'unione senza nome usata per forzare l'allineamento appropriato sulla struttura senza nome.

ConstrainedDataRangesCount

Specifica il numero di voci nella matrice a cui punta ConstrainedDataRanges.

ConstrainedDataRanges

Punta a una matrice di strutture KSDATARANGE . Indica il set di intervalli di dati attualmente supportati dal tipo di pin, in base allo stato interno del driver.