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

指向微型驱动程序的设备扩展的指针。 微型驱动程序可以使用此缓冲区将私有信息全局记录到微型驱动程序。 微型驱动程序在通过 StreamClassRegisterMinidriver 注册自身时,在 HW_INITIALIZATION_DATA 结构中设置此缓冲区的大小。 类驱动程序还会将指针传递给 HwDeviceExtensionHW_STREAM_OBJECTHW_STREAM_REQUEST_BLOCK的此缓冲区,以及传递给微型驱动程序 HW_TIME_CONTEXT 结构。

ClassDeviceObject

指向驱动程序设备提供的类驱动程序功能设备对象(FDO)。

PhysicalDeviceObject

当类驱动程序附加到驱动程序堆栈时,指向驱动程序堆栈顶部的驱动程序的设备对象。 驱动程序在调用 IoCallDriver 以与驱动程序堆栈通信时使用此成员。 RealPhysicalDeviceObject 成员指向驱动程序设备的实际 PDO。

SystemIoBusNumber

类驱动程序使用此设备的系统总线 ID 号填充此成员。 总线 0 是主要系统总线。

AdapterInterfaceType

指定设备连接到的系统总线的类型。 可能的值包括 IsaEisaMicroChannelPCIBusPCMCIABus

BusInterruptLevel

类驱动程序使用 IRQL 填充此成员,以便在此总线上中断。

BusInterruptVector

类驱动程序使用设备使用的中断向量填充此成员。

InterruptMode

类驱动程序使用此中断模式(闩锁模式或 LevelSensitive)填充此成员。

DmaChannel

如果设备连接到 ISA 总线,类驱动程序会用设备的 DMA 通道填充此成员。

NumberOfAccessRanges

AccessRanges 数组中的条目数。

AccessRanges

AccessRanges 数组中的条目数。

StreamDescriptorSize

微型驱动程序用其 HW_STREAM_DESCRIPTOR 结构的大小填充此成员。

Irp

指向触发此SRB_INITIALIZE_DEVICE请求的 PnP 设备启动 IRP 的指针。

InterruptObject

如果设备使用中断,类驱动程序将使用指向关联中断对象的指针填充此成员。

DmaAdapterObject

如果设备使用 DMA,类驱动程序将使用指向关联的 DmaAdapter 对象的指针填充此成员。

RealPhysicalDeviceObject

指向驱动程序设备的 PDO 的指针。

Reserved[1]

保留供系统使用。 请勿使用。

言论

PORT_CONFIGURATION_INFORMATION的大多数成员向微型驱动程序提供有关其使用硬件资源的信息,例如其中断向量和 IRQL,以使其中断。

要求

要求 价值
标头 strmini.h (包括 Strmini.h)