HW_STREAM_INFORMATION結構(strmini.h)
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
此數據流所支援之數據範圍數位開頭的指標。 (這個成員的名稱是欺騙性的。這個成員指向 KSDATARANGE 結構,而不是 KSDATAFORMAT 結構的陣列。
ClassReserved[4]
保留供類別驅動程式使用。 請勿使用。
NumStreamPropArrayEntries
陣列中的項目數,從 StreamPropertiesArray 成員中的地址開始。
StreamPropertiesArray
這個數據流所支援之屬性集數位開頭的指標。
NumStreamEventArrayEntries
陣列中的項目數,從 StreamEventsArray 欄位中的地址開始。
StreamEventsArray
此數據流所支援之事件集數位開頭的指標。
Category
指定針腳類別的 GUID。
Name
指定儲存在登錄中之針腳類型的當地語系化 Unicode 字串名稱 GUID。
MediumsCount
陣列中從 [中] 字段中地址開始的項目數。
Mediums
指向這個數據流所支援之 KSPIN_MEDIUM 結構數位開頭的指標。 如果 minidriver 未指定媒體,則類別驅動程式會使用 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 結構內的索引可作為針腳類型標識碼編號。
請注意,類別驅動程式不會使用此數據來處理 KSPROPERTY_PIN_DATAINTERSECTION 屬性。 如需類別驅動程式如何處理此屬性的描述,請參閱 STREAM_DATA_INTERSECT_INFO。
要求
要求 | 價值 |
---|---|
標頭 | strmini.h (包括 Strmini.h) |