Fonction VideoPortGetBusData (video.h)

Article
03/01/2024

La fonction VideoPortGetBusData retourne des informations de configuration spécifiques au type de bus.

Syntaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortGetBusData(
        PVOID         HwDeviceExtension,
        BUS_DATA_TYPE BusDataType,
        ULONG         SlotNumber,
  [out] PVOID         Buffer,
        ULONG         Offset,
        ULONG         Length
);

Paramètres

HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

BusDataType

Spécifie le type de données de configuration de bus à retourner. La valeur de ce paramètre peut être Cmos, EisaConfiguration ou PCIConfiguration. Toutefois, d’autres types de configuration de bus peuvent être pris en charge à l’avenir. La limite supérieure des types pris en charge est toujours MaximumBusDataType.

SlotNumber

Spécifie l’emplacement de l’appareil sur le bus pour un bus Cmos BusDataType ; zéro pour tous les autres types de bus.

[out] Buffer

Pointeur vers une mémoire tampon dans laquelle VideoPortGetBusData retourne les informations de configuration. Le contenu de la mémoire tampon dépend du BusDataType, comme suit :

Si Cmos est spécifié, la mémoire tampon contient le contenu des emplacements CMOS (numéro de bus est égal à zéro) ou ECMOS (numéro de bus égal à un), en commençant par l’emplacement spécifié pour SlotNumber. La fonction HwVidFindAdapter d’un pilote miniport peut déterminer le numéro du bus à partir du membre SystemIoBusNumber de la structure d’entrée VIDEO_PORT_CONFIG_INFO .
Si EisaConfiguration est spécifié, la mémoire tampon contient la structure CM_EISA_SLOT_INFORMATION , suivie de zéro ou plus CM_EISA_FUNCTION_INFORMATION structures pour l’emplacement spécifié.
Si PCIConfiguration est spécifié, la mémoire tampon contient les informations PCI_COMMON_CONFIG pour l’emplacement spécifié.

Offset

Spécifie le décalage, en octets, dans l’espace de configuration PCI qui doit être récupéré si BusDataType est PCIConfiguration ; sinon zéro. Pour plus d’informations, consultez Remarques .

Length

Spécifie la longueur, en octets, de La mémoire tampon.

Valeur retournée

VideoPortGetBusData retourne le nombre d’octets d’informations de configuration qu’il a écrits dans La mémoire tampon. Si le BusDataType donné n’est pas valide pour la plateforme actuelle, cette fonction retourne généralement zéro.

Code de retour	Description
0	Le bus PCI n’existe pas.
2	Le bus PCI existe, mais la mémoire tampon contient la valeur PCI_INVALID_VENDOR_ID au PCI_COMMON_CONFIG membre VendorId.

Remarques

Pour obtenir uniquement une partie des informations de configuration, le pilote miniport doit définir Offset sur le décalage d’octet des informations nécessaires et définir Longueur sur le nombre d’octets des informations nécessaires. Par exemple, si seul le registre de commandes est nécessaire, définissez Offset sur le décalage de ce registre et définissez Longueur sur sizeof(USHORT).

Le pilote doit appeler VideoPortGetAccessRanges plutôt que VideoPortGetBusData pour récupérer ses ressources matérielles.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	video.h (inclure Video.h)
Bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL