Función VideoPortGetBusData (video.h)
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 |