共用方式為


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_OBJECTHW_STREAM_REQUEST_BLOCK,以及 HW_TIME_CONTEXT 傳遞至迷你驅動程序的結構中的這個緩衝區。

ClassDeviceObject

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

PhysicalDeviceObject

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

SystemIoBusNumber

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

AdapterInterfaceType

指定裝置所連線的系統總線類型。 可能的值為 IsaEisaMicroChannelPCIBusPCMCIABus

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)