estrutura KSPIN_DESCRIPTOR (ks.h)

Artigo
02/26/2024

A estrutura KSPIN_DESCRIPTOR descreve as propriedades básicas de KSPROPSETID_Pin de um tipo de pino.

Sintaxe

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;

Membros

InterfacesCount

Especifica o tamanho da matriz apontada por Interfaces.

Interfaces

Uma matriz de estruturas de KSPIN_INTERFACE especificando as interfaces compatíveis com esse tipo de pino.

MediumsCount

Especifica o número de elementos na matriz apontada por Mediums.

Mediums

Uma matriz de estruturas KSPIN_MEDIUM especificando os meios compatíveis com esse tipo de pino.

DataRangesCount

Especifica o tamanho da matriz apontada por DataRanges.

DataRanges

Uma matriz de estruturas KSDATARANGE especificando os intervalos de dados compatíveis com esse tipo de pino.

DataFlow

Especifica KSPIN_DATAFLOW_IN ou KSPIN_DATAFLOW_OUT. Consulte KSPROPERTY_PIN_DATAFLOW.

Communication

Especifica KSPIN_COMMUNICATION_NONE, KSPIN_COMMUNICATION_SINK, KSPIN_COMMUNICATION_SOURCE, KSPIN_COMMUNICATION_BOTH ou KSPIN_COMMUNICATION_BRIDGE. Consulte KSPROPERTY_PIN_COMMUNICATION para obter o significado de cada valor.

Category

Especifica um ponteiro para um GUID de categoria de pino KS. O GUID da categoria de pino KS identifica a categoria geral de funcionalidade que o pino fornece. Exemplos de GUIDs de categoria de pino KS são KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES e KSNODETYPE_MICROPHONE, que são todos definidos em Ksmedia.h. Consulte também Fixar Propriedade Category.

Name

Especifica o GUID do nome da cadeia de caracteres Unicode localizado para o tipo de pino, armazenado no Registro.

Reserved

Não usado. Um membro de uma união sem nome usada para forçar o alinhamento adequado na estrutura sem nome.

ConstrainedDataRangesCount

Especifica o número de entradas na matriz apontada por ConstrainedDataRanges.

ConstrainedDataRanges

Aponta para uma matriz de estruturas KSDATARANGE . Indica o conjunto de intervalos de dados que o tipo de pino dá suporte no momento, com base no estado interno do driver.