HalSetBusDataByOffset, fonction (ntddk.h)
Avertissement
HalGetBusDataByOffset et halSetBusDataByOffset sont fournis pour la compatibilité descendante, mais doivent être utilisées uniquement si les méthodes recommandées dans Accès à l’espace de configuration d’appareil ne peuvent pas être utilisées.
Cette fonction définit les données de configuration de bus pour un appareil sur un bus d’E/S configurable dynamiquement avec une interface standard publiée.
Syntaxe
NTHALAPI ULONG HalSetBusDataByOffset(
[in] BUS_DATA_TYPE BusDataType,
[in] ULONG BusNumber,
[in] ULONG SlotNumber,
[in] PVOID Buffer,
[in] ULONG Offset,
[in] ULONG Length
);
Paramètres
[in] BusDataType
Données de bus à définir. Cette valeur peut être PCIConfiguration. La limite supérieure des types pris en charge est toujours MaximumBusDataType.
[in] BusNumber
Nombre de bus basé sur zéro et attribué par le système dans les systèmes avec plusieurs bus du même BusDataType. Cet argument porte également le numéro de segment. Pour spécifier le numéro de segment, utilisez (segment << 8) | BusNumber
[in] SlotNumber
Numéro d’emplacement logique ou emplacement de l’appareil. Si vous spécifiez PCIConfiguration comme BusDataType, cette valeur est spécifiée en tant que valeur PCI_SLOT_NUMBER, qui est l’emplacement et les numéros de fonction combinés.
[in] Buffer
Pointeur vers une mémoire tampon fournie par l’appelant pour obtenir des informations de configuration spécifiques à BusDataType.
Si vous spécifiez PCIConfiguration, la mémoire tampon contient les informations d’espace de configuration PCI pour le numéro de fonction et le numéro de fonction spécifiés. Le décalage et la longueur spécifiés déterminent la quantité d’informations à fournir. Certains membres de l’espace de configuration PCI ont des valeurs en lecture seule Que l’appelant est responsable de la préservation des valeurs fournies par le système des membres en lecture seule. Notez que pour un appareil PCI Type-1, HalSetBusDataByOffset empêche les écritures d’enregistrer dans l’en-tête commun (les 256 premiers octets de l’espace de configuration).
[in] Offset
Décalage d’octet dans la structure PCI_COMMON_CONFIG où commencent les valeurs de configuration fournies par l’appelant. Les appelants peuvent utiliser la constante définie par le système PCI_COMMON_HDR_LENGTH pour spécifier la zone spécifique à l’appareil de PCI_COMMON_CONFIG.
[in] Length
Nombre d’octets dans la mémoire tampon.
Valeur de retour
La valeur de retour est la longueur réelle écrite dans l’espace de configuration.
Remarques
Un pilote peut appeler cette fonction ou HalSetBusData si des circonstances inhabituelles ou la nature de son appareil nécessitent un tel appel. Par exemple, un pilote peut appeler l’une de ces fonctions pour effacer un peu dans le registre d’état PCI si son appareil signale une abandon cible pendant l’initialisation. En règle générale, le code de matériel ou de démarrage configure l’appareil de manière appropriée.
Lors de l’accès à la zone spécifique de l’appareil de l’espace de configuration PCI, HalSetBusDataByOffset garantit que cette fonction ne lit jamais ou écrit des données en dehors de la plage spécifiée par le décalage d’entrée et la longueur et même si la longueur d’entrée est exactement un octet ou un mot à deux octets, cette fonction n’accède jamais à des données en dehors de la plage demandée.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntddk.h (include Ntddk.h) |