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結構中設定這個緩衝區的大小。 類別驅動程式也會將指標傳遞給HW_STREAM_OBJECT、HW_STREAM_REQUEST_BLOCK的 HwDeviceExtension 成員中的這個緩衝區，以及傳遞給迷你驅動程式HW_TIME_CONTEXT結構。

ClassDeviceObject

指向驅動程式裝置的類別驅動程式提供的功能裝置物件， (FDO) 。

PhysicalDeviceObject

當類別驅動程式附加至驅動程式堆疊時，指向驅動程式堆疊頂端驅動程式的裝置物件。 驅動程式在呼叫 IoCallDriver 與驅動程式堆棧通訊時，會使用此成員。 RealPhysicalDeviceObject 成員指向驅動程式裝置的實際 PDO。

SystemIoBusNumber

類別驅動程式會填入此成員，其中包含裝置的系統總線標識碼。 總線 0 是主要系統總線。

AdapterInterfaceType

指定裝置所連線的系統總線類型。 可能的值為 Isa、 Eisa、 MicroChannel、 PCIBus 和 PCMCIABus。

BusInterruptLevel

類別驅動程式會以 IRQL 填入此成員，以便在此總線上中斷。

BusInterruptVector

類別驅動程式會填入此成員，其中包含裝置所使用的插斷向量。

InterruptMode

類別驅動程式會以閂鎖或 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)