struktur PORT_CONFIGURATION_INFORMATION (strmini.h)

Artikel
08/07/2023

PORT_CONFIGURATION_INFORMATION menjelaskan pengaturan perangkat keras perangkat minidriver streaming. Driver kelas mengisi sebagian besar anggota dengan informasi yang disediakan oleh sistem operasi.

Sintaks

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;

Anggota

SizeOfThisPacket

Ukuran struktur ini, dalam byte. Driver kelas mengisi anggota ini.

HwDeviceExtension

Arahkan ke ekstensi perangkat minidriver. Minidriver dapat menggunakan buffer ini untuk merekam informasi privat global ke minidriver. Minidriver mengatur ukuran buffer ini dalam struktur HW_INITIALIZATION_DATA yang dilewatinya ketika mendaftarkan dirinya melalui StreamClassRegisterMinidriver. Driver kelas juga meneruskan pointer ke buffer ini di anggota HwDeviceExtension dari struktur HW_STREAM_OBJECT, HW_STREAM_REQUEST_BLOCK, dan HW_TIME_CONTEXT yang diteruskannya ke minidriver.

ClassDeviceObject

Menunjuk ke objek perangkat fungsional yang disediakan driver kelas (FDO) untuk perangkat driver.

PhysicalDeviceObject

Menunjuk ke objek perangkat untuk driver di bagian atas tumpukan driver ketika driver kelas melekat pada tumpukan driver. Driver menggunakan anggota ini saat memanggil IoCallDriver untuk berkomunikasi dengan tumpukan driver. Anggota RealPhysicalDeviceObject menunjuk ke PDO aktual untuk perangkat driver.

SystemIoBusNumber

Driver kelas mengisi anggota ini dengan nomor ID bus sistem perangkat. Bus 0 adalah bus sistem utama.

AdapterInterfaceType

Menentukan jenis bus sistem yang tersambung dengan perangkat. Nilai yang mungkin termasuk Isa, Eisa, MicroChannel, PCIBus, dan PCMCIABus.

BusInterruptLevel

Pengemudi kelas mengisi anggota ini dengan IRQL untuk gangguan pada bus ini.

BusInterruptVector

Driver kelas mengisi anggota ini dengan vektor interupsi yang digunakan oleh perangkat.

InterruptMode

Driver kelas mengisi anggota ini dengan mode interupsi, baik Latched atau LevelSensitive.

DmaChannel

Jika perangkat terhubung ke bus ISA, driver kelas mengisi anggota ini dengan saluran DMA perangkat.

NumberOfAccessRanges

Jumlah entri dalam array AccessRanges .

AccessRanges

Jumlah entri dalam array AccessRanges .

StreamDescriptorSize

Minidriver mengisi anggota ini dengan ukuran struktur HW_STREAM_DESCRIPTOR - nya.

Irp

Penunjuk ke perangkat PnP memulai IRP yang memicu permintaan SRB_INITIALIZE_DEVICE ini.

InterruptObject

Jika perangkat menggunakan interupsi, driver kelas mengisi anggota ini dengan pointer ke objek Interupsi terkait.

DmaAdapterObject

Jika perangkat menggunakan DMA, driver kelas mengisi anggota ini dengan penunjuk ke objek DmaAdapter terkait.

RealPhysicalDeviceObject

Arahkan ke PDO untuk perangkat driver.

Reserved[1]

Dicadangkan untuk penggunaan sistem. Jangan gunakan.

Keterangan

Sebagian besar anggota PORT_CONFIGURATION_INFORMATION memberikan informasi kepada minidriver tentang penggunaan sumber daya perangkat kerasnya, seperti vektor interupsi dan IRQL untuk gangguannya.

Persyaratan

Persyaratan	Nilai
Header	strmini.h (termasuk Strmini.h)

Bagikan melalui