HW_STREAM_INFORMATION構造体は、HW_STREAM_DESCRIPTOR 構造体の一部として、個々のストリームでサポートされるカーネル ストリーミング セマンティクスについて説明します。
構文
typedef struct _HW_STREAM_INFORMATION {
ULONG NumberOfPossibleInstances;
KSPIN_DATAFLOW DataFlow;
BOOLEAN DataAccessible;
ULONG NumberOfFormatArrayEntries;
PKSDATAFORMAT *StreamFormatsArray;
PVOID ClassReserved[4];
ULONG NumStreamPropArrayEntries;
PKSPROPERTY_SET StreamPropertiesArray;
ULONG NumStreamEventArrayEntries;
PKSEVENT_SET StreamEventsArray;
GUID *Category;
GUID *Name;
ULONG MediumsCount;
const KSPIN_MEDIUM *Mediums;
BOOLEAN BridgeStream;
ULONG Reserved[2];
} HW_STREAM_INFORMATION, *PHW_STREAM_INFORMATION;
メンバーズ
NumberOfPossibleInstances
開くことができるこのストリームの可能なインスタンスの数を指定します。
DataFlow
このストリームでデータが移動できる方向。 単一方向のデータ フローの場合、DataFlow には値 KSPIN_DATAFLOW_IN またはKSPIN_DATAFLOW_OUTがあります。
DataAccessible
クラス ドライバー ストリーム データにアクセスできる場合に TRUE を指定します。
NumberOfFormatArrayEntries
StreamFormatsArray メンバーのアドレスから始まる配列内のエントリの数。
StreamFormatsArray
このストリームがサポートするデータ範囲の配列の先頭へのポインター。 (このメンバーの名前は誤解を受けます。このメンバーは、KSDATAFORMAT 構造体ではなく、KSDATARANGE 構造体の配列を指します)。
ClassReserved[4]
クラス ドライバーで使用するために予約されています。 使用しないでください。
NumStreamPropArrayEntries
StreamPropertiesArray メンバー内のアドレスから始まる配列内のエントリの数。
StreamPropertiesArray
このストリームでサポートされているプロパティ セットの配列の先頭へのポインター。
NumStreamEventArrayEntries
StreamEventsArray フィールドのアドレスから始まる配列内のエントリの数。
StreamEventsArray
このストリームでサポートされているイベント セットの配列の先頭へのポインター。
Category
ピン カテゴリの GUID を指定します。
Name
レジストリに格納されているピンの種類のローカライズされた Unicode 文字列名の GUID を指定します。
MediumsCount
Mediums フィールドのアドレスから始まる配列内のエントリの数。
Mediums
このストリームでサポートされている KSPIN_MEDIUM 構造体の配列の先頭へのポインター。 ミニドライバーがメディアを指定しない場合、クラス ドライバーはKSMEDIUMSETID_STANDARD KSMEDIUM_TYPE_ANYINSTANCEメディアを既定として使用します。
BridgeStream
TRUE 場合、このストリームの基になるピンの種類の通信の種類はKSPIN_COMMUNICATION_BRIDGE。 それ以外の場合、ストリームの既定の通信の種類はKSPIN_COMMUNICATION_SINK。
ほとんどのミニドライバーは、このメンバーを FALSEに設定します。 通信の種類の説明については、KSPROPERTY_PIN_COMMUNICATIONSを参照してください。
Reserved[2]
クラス ドライバーで使用するために予約されています。 使用しないでください。
備考
クラス ドライバーは、HW_STREAM_INFORMATIONの要素を使用して、KSPROPSETID_Pin プロパティ要求を処理します。 HW_STREAM_DESCRIPTOR 構造体内のインデックスは、ピンの種類 ID 番号として機能します。
クラス ドライバーでは、このデータを使用して KSPROPERTY_PIN_DATAINTERSECTION プロパティを処理しないことに注意してください。 クラス ドライバーがこのプロパティを処理する方法の詳細については、STREAM_DATA_INTERSECT_INFO を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | strmini.h (Strmini.h を含む) |