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) |