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、およびHW_TIME_CONTEXT構造体の HwDeviceExtension メンバー内のこのバッファーへのポインターも渡します。

ClassDeviceObject

ドライバーのデバイスのクラス ドライバー提供の機能デバイス オブジェクト (FDO) を指します。

PhysicalDeviceObject

クラス ドライバーがドライバー スタックにアタッチされるときに、ドライバー スタックの上部にあるドライバーのデバイス オブジェクトを指します。 ドライバーは、 IoCallDriver を呼び出してドライバー スタックと通信するときに、このメンバーを使用します。 RealPhysicalDeviceObject メンバーは、ドライバーのデバイスの実際の PDO を指します。

SystemIoBusNumber

クラス ドライバーは、このメンバーにデバイスのシステム バス ID 番号を入力します。 バス 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

このSRB_INITIALIZE_DEVICE要求をトリガーした PnP デバイス開始 IRP へのポインター。

InterruptObject

デバイスが割り込みを使用する場合、クラス ドライバーは、関連付けられている割り込みオブジェクトへのポインターをこのメンバーに入力します。

DmaAdapterObject

デバイスで DMA が使用されている場合、クラス ドライバーは、関連付けられている DmaAdapter オブジェクトへのポインターをこのメンバーに入力します。

RealPhysicalDeviceObject

ドライバーのデバイスの PDO へのポインター。

Reserved[1]

システムで使用するために予約されています。 使用しないでください。

注釈

PORT_CONFIGURATION_INFORMATIONのほとんどのメンバーは、割り込みベクトルや割り込みのための IRQL など、ハードウェア リソースの使用に関する情報をミニドライバーに提供します。

要件