Struttura KSDATAFORMAT (ks.h)

  • Articolo

La struttura KSDATAFORMAT è una struttura a lunghezza variabile che descrive un formato di dati.

Sintassi

typedef struct {
  ULONG FormatSize;
  ULONG Flags;
  ULONG SampleSize;
  ULONG Reserved;
  GUID  MajorFormat;
  GUID  SubFormat;
  GUID  Specifier;
} KSDATAFORMAT, *PKSDATAFORMAT, KSDATARANGE, *PKSDATARANGE;

Members

FormatSize

Specifica le dimensioni, in byte, della struttura KSDATAFORMAT. Deve essere almeno sizeof(KSDATAFORMAT), ma può essere più grande per le impostazioni specifiche di MajorFormat, SubFormat e Identificatore. Per altre informazioni, vedere le descrizioni per questi membri.

Flags

Impostare Flag su KSDATAFORMAT_ATTRIBUTES (0x2) per indicare che KSDATAFORMAT è seguito in memoria da una KSMULTIPLE_ITEM di strutture KSATTRIBUTE .

SampleSize

Specifica le dimensioni di esempio dei dati, per le dimensioni fisse di esempio o zero, se il formato ha una dimensione di esempio variabile.

Reserved

Riservato per l'utilizzo nel sistema. I driver devono impostare questo membro su zero.

MajorFormat

Specifica il tipo di formato generale. I formati di dati attualmente supportati sono disponibili nelle costanti simboliche di KSDATAFORMAT_TYPE_XXX nel file di intestazione ksmedia.h incluso nel Driver Kit di Windows (WDK). Un flusso di dati che non ha un formato specifico deve usare KSDATAFORMAT_TYPE_STREAM (definito in ks.h) come valore per Il formato MajorFormat. Per altre informazioni su questo membro, vedere Osservazioni.

SubFormat

Specifica il formato secondario di un tipo di formato generale. I sottoformati di dati attualmente supportati sono disponibili nelle costanti simboliche KSDATAFORMAT_SUBTYPE_XXX nel file di intestazione ksmedia.h incluso nel WDK. I formati principali che non supportano i sottoformati devono usare il valore KSDATAFORMAT_SUBTYPE_NONE per questo membro. Per altre informazioni su questo membro, vedere Osservazioni.

Specifier

Specifica informazioni aggiuntive sul tipo di formato dati per un'impostazione specifica di MajorFormat e SubFormat. Il significato di questo campo è determinato dal formato principale (e sottoformato, se il formato principale supporta i sottoformati). Ad esempio, l'identificatore può rappresentare una determinata codifica di un sottoformato oppure può essere usato per specificare il tipo di struttura di dati seguente KSDATAFORMAT in memoria.

Gli identificatori seguenti (definiti in ks.h) sono di uso generale:

KSDATAFORMAT_SPECIFIER_NONE

Non è disponibile alcun identificatore. Usato per i formati che non supportano gli identificatori.

KSDATAFORMAT_SPECIFIER_FILENAME

Indica che una stringa Unicode con terminazione null segue immediatamente la struttura KSDATAFORMAT in memoria.

KSDATAFORMAT_SPECIFIER_FILEHANDLE

Indica che un handle di file segue immediatamente KSDATAFORMAT in memoria.

Commenti

Al minimo, un formato di dati viene specificato da MajorFormat, subFormat e i membri dell'identificatore . Una famiglia di formati di dati simili può condividere gli stessi valori per MajorFormat, SubFormat e Identificatore. In tal caso, il formato di dati specifico è distinto da dati aggiuntivi che seguono il membro identificatore in memoria.

Per un elenco di combinazioni MajorFormat, SubFormat e Identificatore, vedere categorie Stream e i relativi sottopici.

Requisiti

Requisito Valore
Intestazione ks.h (include Ks.h)

Vedi anche

categorie Stream