PORT_CONFIGURATION_INFORMATION結構(strmini.h)
PORT_CONFIGURATION_INFORMATION描述串流迷你驅動程式裝置的硬體設定。 類別驅動程式會填入大部分成員,其中包含作系統所提供的資訊。
語法
typedef struct _PORT_CONFIGURATION_INFORMATION {
ULONG SizeOfThisPacket;
PVOID HwDeviceExtension;
PDEVICE_OBJECT ClassDeviceObject;
PDEVICE_OBJECT PhysicalDeviceObject;
ULONG SystemIoBusNumber;
INTERFACE_TYPE AdapterInterfaceType;
ULONG BusInterruptLevel;
ULONG BusInterruptVector;
KINTERRUPT_MODE InterruptMode;
ULONG DmaChannel;
ULONG NumberOfAccessRanges;
PACCESS_RANGE AccessRanges;
ULONG StreamDescriptorSize;
PIRP Irp;
PKINTERRUPT InterruptObject;
PADAPTER_OBJECT DmaAdapterObject;
PDEVICE_OBJECT RealPhysicalDeviceObject;
ULONG Reserved[1];
} PORT_CONFIGURATION_INFORMATION, *PPORT_CONFIGURATION_INFORMATION;
成員
SizeOfThisPacket
這個結構的大小,以位元組為單位。 類別驅動程式會填入這個成員。
HwDeviceExtension
迷你驅動程式裝置延伸模組的指標。 minidriver 可以使用這個緩衝區,將全域信息記錄到minidriver。 minidriver 會在它 透過 StreamClassRegisterMinidriver註冊本身時,在 HW_INITIALIZATION_DATA 結構中設定這個緩衝區的大小。 類別驅動程式也會將指標傳遞至 HwDeviceExtension 中HW_STREAM_OBJECT、HW_STREAM_REQUEST_BLOCK,以及 HW_TIME_CONTEXT 傳遞至迷你驅動程序的結構中的這個緩衝區。
ClassDeviceObject
指向驅動程式裝置的類別驅動程式提供的功能性裝置物件 (FDO)。
PhysicalDeviceObject
當類別驅動程式連結至驅動程式堆疊時,指向驅動程式堆疊頂端的驅動程式裝置物件。 驅動程式在呼叫 IoCallDriver 以與驅動程式堆棧通訊時使用此成員。 RealPhysicalDeviceObject 成員指向驅動程式裝置的實際 PDO。
SystemIoBusNumber
類別驅動程式會以裝置的系統總線標識碼填入此成員。 總線 0 是主要系統總線。
AdapterInterfaceType
指定裝置所連線的系統總線類型。 可能的值為 Isa、Eisa、MicroChannel、PCIBus和 PCMCIABus。
BusInterruptLevel
類別驅動程式會填入此成員的 IRQL,以取得此總線上的中斷。
BusInterruptVector
類別驅動程式會以裝置所使用的插斷向量填入此成員。
InterruptMode
類別驅動程式會以插斷模式填入此成員,例如 Latched 或 LevelSensitive。
DmaChannel
如果裝置連線到 ISA 總線,類別驅動程式會以裝置的 DMA 通道填入此成員。
NumberOfAccessRanges
AccessRanges 陣列中的項目數。
AccessRanges
AccessRanges 陣列中的項目數。
StreamDescriptorSize
迷你驅動程式會填入此成員,其 HW_STREAM_DESCRIPTOR 結構的大小。
Irp
PnP 裝置的指標會啟動觸發此SRB_INITIALIZE_DEVICE要求的 IRP。
InterruptObject
如果裝置使用中斷,則類別驅動程式會填入這個成員,其中包含相關聯之 Interrupt 物件的指標。
DmaAdapterObject
如果裝置使用 DMA,類別驅動程式會以相關聯 DmaAdapter 物件的指標填入這個成員。
RealPhysicalDeviceObject
驅動程式裝置的 PDO 指標。
Reserved[1]
保留供系統使用。 請勿使用。
言論
PORT_CONFIGURATION_INFORMATION的大部分成員都會將其使用硬體資源的相關信息提供給迷你驅動程式,例如其插斷向量和 IRQL 來中斷。
要求
要求 | 價值 |
---|---|
標頭 | strmini.h (包括 Strmini.h) |