CM_EISA_SLOT_INFORMATION structure (wdm.h)

Article
02/27/2024

La structure CM_EISA_SLOT_INFORMATION définit les informations d’en-tête de configuration EISA retournées par HalGetBusDatadata pour l’entrée BusDataType = EisaConfiguration, ou par HalGetBusDataByOffset pour les entrées BusDataType = EisaConfiguration et Offset = 0, en supposant que la mémoire tampon allouée à l’appelant est d’une longueur suffisante.

Syntaxe

typedef struct _CM_EISA_SLOT_INFORMATION {
  UCHAR  ReturnCode;
  UCHAR  ReturnFlags;
  UCHAR  MajorRevision;
  UCHAR  MinorRevision;
  USHORT Checksum;
  UCHAR  NumberFunctions;
  UCHAR  FunctionInformation;
  ULONG  CompressedId;
} CM_EISA_SLOT_INFORMATION, *PCM_EISA_SLOT_INFORMATION;

Membres

ReturnCode

Contient un code status si une erreur se produit lorsque le BIOS EISA est interrogé. Les codes status possibles sont les suivants :

EISA_INVALID_SLOT
EISA_INVALID_FUNCTION
EISA_INVALID_CONFIGURATION
EISA_EMPTY_SLOT
EISA_INVALID_BIOS_CALL

ReturnFlags

Indicateurs de retour.

MajorRevision

Informations fournies par le fabricant.

MinorRevision

Informations fournies par le fabricant.

Checksum

Valeur de somme de contrôle, permettant la validation des données de configuration.

NumberFunctions

Numéro à cet emplacement.

FunctionInformation

Indique s’il existe des CM_EISA_FUNCTION_INFORMATION disponibles pour cet emplacement.

CompressedId

Identification compressée EISA de l’appareil à cet emplacement. Cette valeur est identique au membre CompressedId de la structure CM_EISA_FUNCTION_INFORMATION . Ce membre peut être lu pour déterminer si l’appelant doit appeler à nouveau HalGetBusData ou HalGetBusDataByOffset avec suffisamment d’espace tampon pour obtenir des CM_EISA_FUNCTION_INFORMATION plus détaillées pour un appareil qu’il prend en charge.

Remarques

Les informations retournées par HalGetBusData ou HalGetBusDataByOffset dans CM_EISA_SLOT_INFORMATION et dans CM_EISA_FUNCTION_INFORMATION immédiatement après, elles sont en lecture seule.

Le pilote d’un appareil EISA peut appeler HalGetBusData ou HalGetBusDataByOffset pour chaque emplacement de chaque bus EISA dans le système, en demandant uniquement CM_EISA_SLOT_INFORMATION afin de trouver le ou les périphériques qu’il prend en charge en examinant les valeurs CompressedId retournées. Ensuite, un tel pilote peut allouer suffisamment d’espace de mémoire tampon pour appeler à nouveau HalGetBusData(ByOffset) pour CM_EISA_SLOT_INFORMATION et CM_EISA_FUNCTION_INFORMATION aux emplacements où ses périphériques sont trouvés.

Configuration requise

Condition requise	Valeur
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h, Miniport.h)

Voir aussi

CM_EISA_FUNCTION_INFORMATION

HalGetBusData

HalGetBusDataByOffset

Partager via