Función VideoPortGetBusData (video.h)

2025-02-07

La función VideoPortGetBusData devuelve información de configuración específica del tipo de 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 se admita en el futuro 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 de un Cmos BusDataType; 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 del BusDataType, como se indica a continuación:

Si se especifica Cmos, el búfer contiene el contenido del CMOS (número de bus es igual a cero) o las ubicaciones ECMOS (número de bus igual a uno), empezando por la ubicación especificada para SlotNumber. Una función de HwVidFindAdapter del controlador de miniporte puede determinar el número del bus desde el 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 CM_EISA_FUNCTION_INFORMATION para la ranura especificada.
Si se especifica PCIConfiguration, el búfer contiene la información 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 obtener más información.

Length

Especifica la longitud, en bytes, de Búfer.

Valor devuelto

VideoPortGetBusData devuelve el número de bytes de información de configuración que ha escrito en Buffer. Si la BusDataType especificada no es válida para la plataforma actual, esta función normalmente 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.

Observaciones

Para obtener solo una parte de la información de configuración, el controlador de miniport debe establecer Desplazamiento 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 desplazamiento en el desplazamiento de este registro y establezca longitud en tamaño de(USHORT).

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

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
de la plataforma de destino de	Escritorio
encabezado de	video.h (incluya Video.h)
biblioteca de	Videoprt.lib
DLL de	Videoprt.sys
irQL	PASSIVE_LEVEL