次の方法で共有

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 など、ハードウェア リソースの使用に関する情報をミニドライバーに提供します。

必要条件

要件 価値
ヘッダー strmini.h (Strmini.h を含む)