estructura KSPIN_DESCRIPTOR (ks.h)

Artículo
08/07/2023

La estructura KSPIN_DESCRIPTOR describe las propiedades básicas de KSPROPSETID_Pin de un tipo de patilla.

Sintaxis

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;

Miembros

InterfacesCount

Especifica el tamaño de la matriz a la que apuntan interfaces.

Interfaces

Matriz de estructuras de KSPIN_INTERFACE que especifican las interfaces admitidas por este tipo de patilla.

MediumsCount

Especifica el número de elementos de la matriz a la que apunta Mediums.

Mediums

Matriz de estructuras de KSPIN_MEDIUM que especifican los medios admitidos por este tipo de patilla.

DataRangesCount

Especifica el tamaño de la matriz a la que apunta DataRanges.

DataRanges

Matriz de estructuras KSDATARANGE que especifican los intervalos de datos admitidos por este tipo de patilla.

DataFlow

Especifica KSPIN_DATAFLOW_IN o KSPIN_DATAFLOW_OUT. Consulte KSPROPERTY_PIN_DATAFLOW.

Communication

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

Category

Especifica un puntero a un GUID de categoría de patillas KS. El GUID de categoría de patillas KS identifica la categoría general de funcionalidad que proporciona el pin. Algunos ejemplos de GUID de categoría de pin KS son KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES y KSNODETYPE_MICROPHONE, que se definen en Ksmedia.h. Vea también Pin Category (propiedad).

Name

Especifica el GUID del nombre de cadena Unicode localizado para el tipo de patilla, almacenado en el Registro.

Reserved

No se usa. Miembro de una unión sin nombre utilizada para forzar la alineación adecuada en la estructura sin nombre.

ConstrainedDataRangesCount

Especifica el número de entradas de la matriz a las que apunta ConstrainedDataRanges.

ConstrainedDataRanges

Apunta a una matriz de estructuras KSDATARANGE . Indica el conjunto de intervalos de datos que admite actualmente el tipo de patilla, en función del estado interno del controlador.