KSDATAFORMAT 構造体 (ks.h)

[アーティクル]
08/07/2023

KSDATAFORMAT 構造体は、データ形式を記述する可変長構造体です。

構文

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

メンバー

FormatSize

KSDATAFORMAT 構造体のサイズをバイト単位で指定します。これは、少なくとも sizeof(KSDATAFORMAT) である必要がありますが、MajorFormat、SubFormat、および Specifier の特定の設定では大きくすることができます。詳細については、これらのメンバーの説明を参照してください。

Flags

KSDATAFORMAT の後に KSATTRIBUTE 構造体のKSMULTIPLE_ITEMが続く場合は、フラグを KSDATAFORMAT_ATTRIBUTES (0x2) に設定します。

SampleSize

固定サンプルサイズのデータのサンプルサイズを指定します。形式に可変のサンプルサイズがある場合は 0 を指定します。

Reserved

システムで使用するために予約されています。ドライバーは、このメンバーを 0 に設定する必要があります。

MajorFormat

一般的な書式の種類を指定します。現在サポートされているデータ形式は、Windows Driver Kit (WDK) に含まれている ksmedia.h ヘッダーファイルのKSDATAFORMAT_TYPE_XXXシンボリック定数にあります。特定の形式を持たないデータストリームでは、majorFormat の値として KSDATAFORMAT_TYPE_STREAM (ks.h で定義) を使用する必要があります。このメンバーの詳細については、「解説」を参照してください。

SubFormat

一般的な書式の種類のサブフォーマットを指定します。現在サポートされているデータサブフォーマットは、WDK に含まれる ksmedia.h ヘッダーファイルのKSDATAFORMAT_SUBTYPE_XXXシンボリック定数にあります。サブフォーマットをサポートしていない主な形式では、このメンバーのKSDATAFORMAT_SUBTYPE_NONE値を使用する必要があります。このメンバーの詳細については、「解説」を参照してください。

Specifier

MajorFormat と SubFormat の特定の設定に関する追加のデータ形式の型情報を指定します。このフィールドの意味は、メジャー形式 (およびメジャー形式がサブフォーマットをサポートしている場合はサブフォーマット) によって決定されます。たとえば、 指定子 はサブフォーマットの特定のエンコーディングを表したり、メモリ内の KSDATAFORMAT に続くデータ構造の種類を指定するために使用したりできます。

次の指定子 ( ks.h で定義) は一般的に使用されます。

KSDATAFORMAT_SPECIFIER_NONE

指定子なしを表します。指定子をサポートしない形式に使用されます。

KSDATAFORMAT_SPECIFIER_FILENAME

null で終わる Unicode 文字列が、メモリ内の KSDATAFORMAT 構造体の直後にあることを示します。

KSDATAFORMAT_SPECIFIER_FILEHANDLE

メモリ内の KSDATAFORMAT の直後にファイルハンドルがあることを示します。

注釈

少なくとも、データ形式は MajorFormat、 SubFormat、および Specifier メンバーによって指定されます。同様のデータ形式のファミリは、 MajorFormat、 SubFormat、および Specifier で同じ値を共有できます。その場合、特定のデータ形式は、メモリ内の 指定子 メンバーに続く追加のデータによって区別されます。

MajorFormat、SubFormat、および Specifier の組み合わせの一覧については、「Stream カテゴリとそのサブトピック」を参照してください。

要件

要件	値
Header	ks.h (Ks.h を含む)

こちらもご覧ください

ストリームのカテゴリ