struttura KSPIN_DESCRIPTOR (ks.h)
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;
Membri
InterfacesCount
Specifica le dimensioni della matrice a cui punta 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 medium.
Mediums
Matrice di strutture KSPIN_MEDIUM che specificano i supporti supportati da questo tipo di pin.
DataRangesCount
Specifica le dimensioni della matrice a cui punta 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. Per il significato di ogni valore, vedere KSPROPERTY_PIN_COMMUNICATION.
Category
Specifica un puntatore a un GUID della categoria di pin KS. Il GUID della categoria di pin KS identifica la categoria generale di funzionalità fornita dal pin. Esempi di GUID di categoria pin KS sono KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES e KSNODETYPE_MICROPHONE, tutti definiti in Ksmedia.h. Vedere anche proprietà Aggiungi categoria.
Name
Specifica il GUID del nome della stringa Unicode localizzata per il tipo di pin archiviato nel Registro di sistema.
Reserved
Non utilizzato. Membro di un'unione senza nome utilizzata per forzare l'allineamento corretto sulla struttura senza nome.
ConstrainedDataRangesCount
Specifica il numero di voci nella matrice a cui punta ConstrainedDataRanges.
ConstrainedDataRanges
Punta a una matrice di strutture di KSDATARANGE. Indica il set di intervalli di dati attualmente supportati dal tipo di pin, in base allo stato interno del driver.
Osservazioni
I driver definiscono in genere una struttura KSPIN_DESCRIPTOR per ogni tipo di pin supportato.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | ks.h (include Ks.h) |