Fonction VideoPortGetBusData (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 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 |