Partager via


VideoPortGetBusData, fonction (video.h)

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 Cmos BusDataType; zéro pour tous les autres types de bus.

[out] Buffer

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

  • Si Cmos est spécifié, la mémoire tampon contient le contenu du CMOS (numéro de bus égal à zéro) ou des emplacements 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 nombre de bus à partir du SystemIoBusNumber membre 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 plusieurs structures CM_EISA_FUNCTION_INFORMATION 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 tampon.

Valeur de retour

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

Retourner le code Description
0 Le bus PCI n’existe pas.
2 Le bus PCI existe, mais Buffer contient la valeur PCI_INVALID_VENDOR_ID au membre PCI_COMMON_CONFIG 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 décalage sur le décalage de ce registre et définissez Longueur sur taille de(USHORT).

Le pilote doit appeler VideoPortGetAccessRanges au lieu de VideoPortGetBusData pour récupérer ses ressources matérielles.

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible Bureau
d’en-tête video.h (include Video.h)
bibliothèque Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

Voir aussi

CM_EISA_FUNCTION_INFORMATION

CM_EISA_SLOT_INFORMATION

HwVidQueryDeviceCallback

PCI_COMMON_CONFIG

PCI_SLOT_NUMBER

VIDEO_PORT_CONFIG_INFO

VideoPortGetAccessRanges

VideoPortGetDeviceBase

VideoPortGetDeviceData

VideoPortGetRegistryParameters