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 |