PORT_CONFIGURATION_INFORMATION struttura (strmini.h)

Articolo
03/05/2024

PORT_CONFIGURATION_INFORMATION descrive le impostazioni hardware di un dispositivo minidriver di streaming. Il driver di classe riempie la maggior parte dei membri con informazioni fornite dal sistema operativo.

Sintassi

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;

Members

SizeOfThisPacket

Dimensioni di questa struttura, in byte. Il driver di classe compila questo membro.

HwDeviceExtension

Puntatore all'estensione del dispositivo del minidriver. Il minidriver può usare questo buffer per registrare informazioni private globali nel minidriver. Il minidriver imposta le dimensioni di questo buffer nella struttura HW_INITIALIZATION_DATA che passa quando si registra tramite StreamClassRegisterMinidriver. Il driver di classe passa anche puntatori a questo buffer nel membro HwDeviceExtension del HW_STREAM_OBJECT, HW_STREAM_REQUEST_BLOCK e HW_TIME_CONTEXT strutture che passa al minidriver.

ClassDeviceObject

Punta all'oggetto dispositivo funzionale fornito dal driver di classe (FDO) per il dispositivo del driver.

PhysicalDeviceObject

Punta all'oggetto dispositivo per il driver nella parte superiore dello stack di driver quando il driver di classe si collega allo stack di driver. I driver usano questo membro quando si chiama IoCallDriver per comunicare con lo stack di driver. Il membro RealPhysicalDeviceObject punta al PDO effettivo per il dispositivo del driver.

SystemIoBusNumber

Il driver di classe compila questo membro con il numero ID del bus di sistema del dispositivo. Il bus 0 è il bus di sistema primario.

AdapterInterfaceType

Specifica il tipo di bus di sistema a cui è connesso il dispositivo. I valori possibili includono Isa, Eisa, MicroChannel, PCIBus e PCMCIABus.

BusInterruptLevel

Il driver di classe riempie questo membro con IRQL per interrompere il bus.

BusInterruptVector

Il driver di classe riempie questo membro con il vettore di interruzione usato dal dispositivo.

InterruptMode

Il driver di classe riempie questo membro con la modalità di interruzione, latched o LevelSensitive.

DmaChannel

Se il dispositivo si connette al bus ISA, il driver di classe riempie questo membro con il canale DMA del dispositivo.

NumberOfAccessRanges

Numero di voci nella matrice AccessRanges .

AccessRanges

Numero di voci nella matrice AccessRanges .

StreamDescriptorSize

Il minidriver riempie questo membro con la dimensione della sua struttura HW_STREAM_DESCRIPTOR .

Irp

Puntatore al dispositivo PnP avvia IRP che ha attivato questa richiesta di SRB_INITIALIZE_DEVICE.

InterruptObject

Se il dispositivo usa interruzioni, il driver di classe riempie questo membro con un puntatore all'oggetto Interrupt associato.

DmaAdapterObject

Se il dispositivo usa DMA, il driver di classe riempie questo membro con un puntatore all'oggetto DmaAdapter associato.

RealPhysicalDeviceObject

Puntatore all'oggetto PDO per il dispositivo del driver.

Reserved[1]

Riservato per l'utilizzo nel sistema. Non usare.

Commenti

La maggior parte dei membri di PORT_CONFIGURATION_INFORMATION fornisce informazioni al minidriver sull'uso delle risorse hardware, ad esempio il relativo vettore di interruzione e irQL per i relativi interruzioni.

Requisiti

Requisito	Valore
Intestazione	strmini.h (include Strmini.h)

Condividi tramite