структура 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

Указатель на расширение устройства мини-драйвера. Мини-диск может использовать этот буфер для записи личной информации, глобальной в мини-диск. Мини-driver задает размер этого буфера в HW_INITIALIZATION_DATA структуре, которая передается при регистрации через StreamClassRegisterMinidriver. Драйвер класса также передает указатели на этот буфер в элементе HwDeviceExtensionHW_STREAM_OBJECT, HW_STREAM_REQUEST_BLOCK и HW_TIME_CONTEXT структурах, которые он передает в мини-диск.

ClassDeviceObject

Указывает на предоставляемый классом драйвером объект функционального устройства (FDO) для устройства драйвера.

PhysicalDeviceObject

Указывает на объект устройства для драйвера в верхней части стека драйверов, когда драйвер класса присоединяется к стеку драйверов. Драйверы используют этот элемент при вызове IoCallDriver для взаимодействия со стеком драйверов. Элемент RealPhysicalDeviceObject указывает на фактическое PDO для устройства драйвера.

SystemIoBusNumber

Драйвер класса заполняет этот элемент идентификатором системной шины устройства. Шина 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

Указатель на запуск IRP устройства PnP, который активировал этот запрос SRB_INITIALIZE_DEVICE.

InterruptObject

Если устройство использует прерывания, драйвер класса заполняет этот элемент указателем на связанный объект Прерывание.

DmaAdapterObject

Если устройство использует DMA, драйвер класса заполняет этот элемент указателем на связанный объект DmaAdapter.

RealPhysicalDeviceObject

Указатель на PDO для устройства драйвера.

Reserved[1]

Зарезервировано для системного использования. Не используйте.

Комментарии

Большинство членов PORT_CONFIGURATION_INFORMATION предоставляют мини-накопителю сведения об использовании аппаратных ресурсов, таких как вектор прерываний и IRQL для прерываний.

Требования