structure HW_INITIALIZATION_DATA (storport.h)

Article
12/22/2024

La structure HW_INITIALIZATION_DATA (Storport) contient des informations particulières à chaque pilote miniport et le matériel que le pilote miniport gère.

Syntaxe

typedef struct _HW_INITIALIZATION_DATA {
  ULONG                       HwInitializationDataSize;
  INTERFACE_TYPE              AdapterInterfaceType;
  PHW_INITIALIZE              HwInitialize;
  PHW_STARTIO                 HwStartIo;
  PHW_INTERRUPT               HwInterrupt;
  PVOID                       HwFindAdapter;
  PHW_RESET_BUS               HwResetBus;
  PHW_DMA_STARTED             HwDmaStarted;
  PHW_ADAPTER_STATE           HwAdapterState;
  ULONG                       DeviceExtensionSize;
  ULONG                       SpecificLuExtensionSize;
  ULONG                       SrbExtensionSize;
  ULONG                       NumberOfAccessRanges;
  PVOID                       Reserved;
  UCHAR                       MapBuffers;
  BOOLEAN                     NeedPhysicalAddresses;
  BOOLEAN                     TaggedQueuing;
  BOOLEAN                     AutoRequestSense;
  BOOLEAN                     MultipleRequestPerLu;
  BOOLEAN                     ReceiveEvent;
  USHORT                      VendorIdLength;
  PVOID                       VendorId;
  union {
    USHORT ReservedUshort;
    USHORT PortVersionFlags;
  };
  USHORT                      DeviceIdLength;
  PVOID                       DeviceId;
  PHW_ADAPTER_CONTROL         HwAdapterControl;
  PHW_BUILDIO                 HwBuildIo;
  PHW_FREE_ADAPTER_RESOURCES  HwFreeAdapterResources;
  PHW_PROCESS_SERVICE_REQUEST HwProcessServiceRequest;
  PHW_COMPLETE_SERVICE_IRP    HwCompleteServiceIrp;
  PHW_INITIALIZE_TRACING      HwInitializeTracing;
  PHW_CLEANUP_TRACING         HwCleanupTracing;
  PHW_TRACING_ENABLED         HwTracingEnabled;
  ULONG                       FeatureSupport;
  ULONG                       SrbTypeFlags;
  ULONG                       AddressTypeFlags;
  ULONG                       Reserved1;
  PHW_UNIT_CONTROL            HwUnitControl;
} HW_INITIALIZATION_DATA, *PHW_INITIALIZATION_DATA;

Membres

HwInitializationDataSize

Spécifie la taille de cette structure en octets, comme retourné par sizeof(HW_INITIALIZATION_DATA). En effet, ce membre indique la version de cette structure utilisée par le pilote miniport. La routine DriverEntry d’un pilote miniport doit définir la valeur de ce membre pour le pilote de port.

AdapterInterfaceType

Le pilote Storport ne prend pas en charge les bus hérités. Par conséquent, la plupart des types d’interface d’adaptateur utilisés avec le pilote de port SCSI ne sont pas valides pour Storport. En particulier, Isa, Eisa, MicroChannelet TurboChannel ne sont pas pris en charge. En outre, contrairement au cas de port SCSI, un pilote miniport qui fonctionne avec le pilote Storport n’est pas nécessaire pour fournir des valeurs pour les membres VendorIdLength, VendorId, DeviceIdLengthet DeviceId membres.

HwInitialize

Pointeur vers le du pilote miniport HwStorInitialize routine, qui est un point d’entrée requis pour tous les pilotes miniports.

HwStartIo

Pointeur vers la routine du pilote miniport HwStorStartIo, qui est un point d’entrée requis pour tous les pilotes miniports.

HwInterrupt

Pointeur vers la routine du pilote miniport HwStorInterrupt, qui est un point d’entrée requis pour tous les pilotes miniport.

HwFindAdapter

Pointeur vers la routine HwStorFindAdapter du pilote miniport, qui est un point d’entrée requis pour tous les pilotes miniports.

HwResetBus

Pointeur vers la routine du pilote miniport HwStorResetBus, qui est un point d’entrée requis pour tous les pilotes miniports.

HwDmaStarted

Le pilote Storport ne prend pas en charge la DMA en mode subordonné. Par conséquent, ce membre doit être NULL.

HwAdapterState

Le pilote Storport ne prend pas en charge les pilotes hérités. Par conséquent, ce membre doit être NULL.

DeviceExtensionSize

Spécifie la taille, en octets, requise par le pilote miniport pour son extension de périphérique par adaptateur. Un pilote miniport utilise son extension de périphérique comme stockage pour les informations sur l’adaptateur de bus hôte (HBA) déterminé par le pilote. Le pilote de port spécifique au système d’exploitation initialise chaque extension de périphérique une fois, lorsqu’il alloue d’abord l’extension et le remplit avec des zéros. Il transmet un pointeur à l’extension de périphérique spécifique à l’adaptateur HBA dans chaque appel à un pilote miniport. La taille donnée n’inclut aucun stockage par unité logique demandé par pilote miniport. La taille du stockage par unité logique est spécifiée via le champ SpecificLuExtensionSize, décrit plus loin dans cette rubrique.

Bien que SCSIPort réinitialise l’extension d’appareil chaque fois que l’adaptateur est arrêté et que les appels suivants à HwScsiFindAdapter reçoivent une extension d’appareil zéro, Storport ne suit pas ce modèle. Au lieu de cela, Storport réinitialise l’extension d’appareil à zéro uniquement lorsqu’elle est allouée pour la première fois. Par conséquent, seul le premier appel à HwStorFindAdapter pour une carte donnée reçoit une extension d’appareil sans sortie. Les appels suivants à HwStorFindAdapter et d’autres fonctions miniport reçoivent l’extension de l’appareil comme dernière modification par le miniport. Cela permet au pilote miniport de conserver des connaissances sur l’état de l’adaptateur entre plug-and-play (PnP) s’arrête et redémarre, ce qui permet éventuellement au pilote miniport d’optimiser sa procédure d’initialisation.

SpecificLuExtensionSize

Spécifie la taille en octets requise par le pilote miniport pour son stockage par unité logique, le cas échéant. Un pilote miniport peut utiliser ses extensions LU comme stockage pour les informations d’unité logique déterminée par le pilote sur les périphériques du bus. Le pilote Storport initialise chaque extension lu qu’il alloue avec zéros. Laissez ce membre défini sur zéro si le pilote miniport ne conserve pas les informations par lu pour lesquelles il nécessite un stockage. Cette valeur est basée sur l’hypothèse que l’adaptateur HBA peut recevoir des adresses 32 bits, quelle que soit la prise en charge du contrôleur. Si un espace supplémentaire est nécessaire dans les extensions LUN ou SRB pour gérer les adresses 64 bits, les ajustements appropriés doivent être apportés à cette valeur avant de l’utiliser avec des routines telles que StorPortGetUncachedExtension.

SrbExtensionSize

Spécifie la taille, en octets, requise par le pilote miniport pour son stockage par requête, le cas échéant. Un pilote miniport peut utiliser des extensions SRB comme stockage pour les informations spécifiques au pilote, telles que les données nécessaires pour traiter une requête particulière. Le pilote Storport n’initialise pas les extensions SRB, mais définit un pointeur vers ce stockage dans chaque SRB qu’il envoie au pilote miniport. Une extension SRB est accessible en toute sécurité par le matériel HBA. Étant donné que les pilotes miniport qui fonctionnent avec le pilote Storport doivent prendre en charge les listes de nuages de points/regroupements, et les listes de nuages de points/regroupements par SRB sont généralement allouées dans l’extension SRB, ce membre est rarement zéro. Laissez ce membre défini sur zéro si le pilote miniport ne conserve pas les informations par SRB pour lesquelles il nécessite un stockage.

Cette valeur est basée sur l’hypothèse que l’adaptateur HBA peut recevoir des adresses 32 bits, quelle que soit la prise en charge du contrôleur. Si un espace supplémentaire est nécessaire dans les extensions LUN ou SRB pour gérer les adresses 64 bits, les ajustements appropriés doivent être apportés à cette valeur avant de l’utiliser avec des routines telles que StorPortGetUncachedExtension.

NumberOfAccessRanges

Spécifie le nombre de plages d’accès que l’adaptateur utilise. Il s’agit d’une plage d’adresses mémoire ou d’adresses de port d’E/S.

Reserved

Réservé à l’utilisation du système et non disponible pour une utilisation par les pilotes miniport.

MapBuffers

Indique si le pilote Storport mappe les adresses de mémoire tampon de données SRB aux adresses virtuelles système. Les MapBuffers membre peuvent avoir l’une des valeurs suivantes.

Valeur	Signification
STOR_MAP_NO_BUFFERS (0)	Ne mappez aucune SRB, sauf SRB_FUNCTION_IO_CONTROL et SRB_FUNCTION_WMI.
STOR_MAP_ALL_BUFFERS (1)	Obsolète. Cette valeur a le même effet que STOR_MAP_NON_READ_WRITE_BUFFERS.
STOR_MAP_NON_READ_WRITE_BUFFERS (2)	Mappez la mémoire tampon pour toutes les E/S, à l’exception des demandes de lecture ou d’écriture.
STOR_MAP_ALL_BUFFERS_INCLUDING_READ_WRITE (3)	Mappez la mémoire tampon pour toutes les E/S, y compris les demandes de lecture et d’écriture. Cette valeur est valide à partir de Windows 8.

NeedPhysicalAddresses

Doit être défini sur TRUE. Une valeur de TRUE indique que le pilote miniport doit traduire certains types d’adresses en adresses physiques. Les pilotes miniports qui fonctionnent avec le pilote Storport doivent prendre en charge la DMA maître de bus. Ils seront donc toujours nécessaires pour effectuer la traduction d’adresses.

TaggedQueuing

Doit être défini sur TRUE. La valeur TRUE indique que le pilote miniport prend en charge la mise en file d’attente SCSI étiquetée. Tous les pilotes miniports qui fonctionnent avec le pilote Storport doivent prendre en charge la mise en file d’attente marquée.

AutoRequestSense

Doit être TRUE. Une valeur de TRUE indique que l’adaptateur HBA peut effectuer une opération de sens des requêtes sans exiger qu’une requête explicite le fasse. Tous les pilotes miniport qui fonctionnent avec le pilote Storport doivent prendre en charge SCSI Auto-Request Sense.

MultipleRequestPerLu

Doit être défini sur TRUE. La valeur TRUE indique que le pilote miniport peut mettre en file d’attente plusieurs requêtes par unité logique. Les pilotes Miniport qui fonctionnent avec le pilote Storport doivent prendre en charge plusieurs requêtes par unité logique.

ReceiveEvent

Le pilote Storport ignore ce membre.

VendorIdLength

Le pilote Storport ignore ce membre, car les pilotes miniport qui fonctionnent avec le pilote Storport doivent prendre en charge PnP.

VendorId

Le pilote Storport ignore ce membre, car les pilotes miniport qui fonctionnent avec le pilote Storport doivent prendre en charge PnP.

ReservedUshort

PortVersionFlags

Indicateurs pour indiquer les fonctionnalités prises en charge.

DeviceIdLength

Le pilote Storport ignore ce membre, car les pilotes miniport qui fonctionnent avec le pilote Storport doivent prendre en charge PnP.

DeviceId

Le pilote Storport ignore ce membre, car les pilotes miniport qui fonctionnent avec le pilote Storport doivent prendre en charge PnP.

HwAdapterControl

Pointeur vers la routine HwStorAdapterControl du pilote miniport. Il s’agit d’une routine requise, car les pilotes miniports qui fonctionnent avec le pilote Storport nécessitent la prise en charge de PnP.

HwBuildIo

Pointeur vers une routine facultative HwStorBuildIo que le pilote de port appelle pour effectuer un traitement non synchronisé avant d’appeler la routine du pilote miniport HwStorStartIo. Ce rappel est spécifique aux miniports physiques et doit être défini sur NULL par miniports virtuels.

HwFreeAdapterResources

Pointeur vers le HwStorFreeAdapterResources du pilote miniport virtuel routine, qui est un point d’entrée requis pour tous les pilotes miniport virtuels. Ce rappel est spécifique aux miniports virtuels et est défini sur NULL pour les miniports physiques.