Función VideoPortGetBusData (video.h)

Artículo
08/07/2023

La función VideoPortGetBusData devuelve información de configuración específica del tipo bus.

Sintaxis

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

Parámetros

HwDeviceExtension

Puntero a la extensión del dispositivo del controlador de minipuerto.

BusDataType

Especifica el tipo de datos de configuración de bus que se van a devolver. El valor de este parámetro puede ser Cmos, EisaConfiguration o PCIConfiguration. Sin embargo, es posible que en el futuro se admita tipos adicionales de configuración de bus. El límite superior de los tipos admitidos siempre es MaximumBusDataType.

SlotNumber

Especifica la ubicación del dispositivo en el bus para un BusDataType de Cmos; cero para todos los demás tipos de bus.

[out] Buffer

Puntero a un búfer en el que VideoPortGetBusData devuelve la información de configuración. El contenido del búfer depende de BusDataType, como se indica a continuación:

Si se especifica Cmos , el búfer contiene el contenido de las ubicaciones CMOS (número de bus igual a cero) o ECMOS (número de bus igual a uno), empezando por la ubicación especificada para SlotNumber. Una función HwVidFindAdapter del controlador de miniporte puede determinar el número del bus del miembro SystemIoBusNumber de la estructura de entrada de VIDEO_PORT_CONFIG_INFO .
Si se especifica EisaConfiguration , el búfer contiene la estructura CM_EISA_SLOT_INFORMATION , seguida de cero o más estructuras de CM_EISA_FUNCTION_INFORMATION para la ranura especificada.
Si se especifica PCIConfiguration , el búfer contiene la información de PCI_COMMON_CONFIG de la ranura especificada.

Offset

Especifica el desplazamiento, en bytes, en el espacio de configuración pci que se debe recuperar si BusDataType es PCIConfiguration; de lo contrario, cero. Consulte Comentarios para más información.

Length

Especifica la longitud, en bytes, del búfer.

Valor devuelto

VideoPortGetBusData devuelve el número de bytes de información de configuración que ha escrito en buffer. Si busDataType especificado no es válido para la plataforma actual, esta función generalmente devuelve cero.

Código devuelto	Descripción
0	El bus PCI no existe.
2	El bus PCI existe, pero Buffer contiene el valor PCI_INVALID_VENDOR_ID en el miembro vendorId de PCI_COMMON_CONFIG.

Comentarios

Para obtener solo una parte de la información de configuración, el controlador de minipuerto debe establecer Offset en el desplazamiento de bytes de la información necesaria y establecer Longitud en el número de bytes de la información necesaria. Por ejemplo, si solo se necesita el registro de comandos, establezca Offset en el desplazamiento de este registro y establezca Length en sizeof(USHORT).

El controlador debe llamar a VideoPortGetAccessRanges en lugar de VideoPortGetBusData para recuperar sus recursos de hardware.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	video.h (incluya Video.h)
Library	Videoprt.lib
Archivo DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL