Partager via


IDE_CHANNEL_CONFIGURATION structure (irb.h)

La structure IDE_CHANNEL_CONFIGURATION contient des informations de configuration pour le canal indiqué.

Notes

Les modèles de pilote de port ATA et de pilote miniport ATA peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser les modèles de pilote Storport et de pilote miniport Storport .

Syntaxe

typedef struct _IDE_CHANNEL_CONFIGURATION {
  USHORT                              Version;
  UCHAR                               ChannelNumber;
  SUPPORTED_ADVANCES                  SupportedAdvances;
  IDE_OPERATION_MODE                  ChannelMode;
  PIDE_MINIPORT_RESOURCES             ChannelResources;
  UCHAR                               NumberOfOverlappedRequests;
  UCHAR                               MaxTargetId;
  BOOLEAN                             SyncWithIsr;
  BOOLEAN                             SupportsWmi;
  PIDE_ADVANCED_CHANNEL_CONFIGURATION AdvancedChannelConfiguration;
} IDE_CHANNEL_CONFIGURATION, *PIDE_CHANNEL_CONFIGURATION;

Membres

Version

Le pilote de port définit ce membre sur sizeof(IDE_CHANNEL_CONFIGURATION). Le pilote miniport doit vérifier que la version est supérieure ou égale à celle qu’il utilise.

ChannelNumber

Le pilote de port définit ce champ sur le numéro attribué pour ce canal. Pour les contrôleurs en mode non natif, le canal principal est toujours affecté à 0 et le canal secondaire est toujours affecté à 1.

SupportedAdvances

Réservé ; ne pas utiliser.

ChannelMode

Le pilote de port définit ce champ pour indiquer au miniport ATA le mode dans lequel il s’exécute. Il existe trois modes possibles :

Mode Description
IdeModeNormal Il s’agit du mode de fonctionnalités complètes standard où le miniport ATA peut fonctionner normalement.
IdeModeDump Il s’agit du mode limité sans mémoire dans lequel un miniport ATA fonctionne pendant la mise en veille prolongée ou le crashdump. Les routines de rappel et les routines d’accès au Registre ne peuvent pas être utilisées dans ce mode.
IdeModeRemovableBay Comme pour IdeModeNormal, cela indique que le miniport ATA doit prendre des mesures supplémentaires pour activer l’énumération des appareils qui viennent d’être branchés à chaud sur un bus Parallel ATA.

ChannelResources

Le pilote de port utilise ce pointeur pour passer des ressources matérielles miniport à utiliser pour accéder à l’adaptateur HBA sur un bus PCI.

NumberOfOverlappedRequests

Le pilote miniport doit définir ce champ sur le nombre de demandes que le canal peut gérer à la fois. Par défaut, le pilote de port définit cette valeur sur 1.

MaxTargetId

Le miniport doit définir ce membre sur l’ID cible maximal pris en charge sur ce canal. En règle générale, il s’agit de 1 de moins que le nombre maximal d’appareils pris en charge sur le canal. Par défaut, le pilote de port définit cette valeur sur 1 pour indiquer que 2 appareils sont pris en charge sur un canal.

SyncWithIsr

Indique la prise en charge du traitement des E/S non synchronisées dans le pilote miniport. Le pilote miniport doit définir ce membre sur TRUE.

SupportsWmi

Indique la prise en charge de WMI. Le pilote miniport doit définir ce membre sur TRUE.

AdvancedChannelConfiguration

Réservé à l’utilisation du système ; n’utilisez pas.

Configuration requise

Condition requise Valeur
En-tête irb.h (include Irb.h)