Función VideoPortSetBusData (video.h)

La función VideoPortSetBusData establece los datos de configuración de bus para un adaptador en un bus de E/S configurable dinámicamente con una interfaz estándar publicada.

Sintaxis

VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortSetBusData(
       PVOID         HwDeviceExtension,
       BUS_DATA_TYPE BusDataType,
       ULONG         SlotNumber,
  [in] 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 bus que se van a establecer. Actualmente, su valor puede ser una de Cmos, EisaConfiguration o PCIConfiguration. Sin embargo, es posible que en el futuro se admita más tipos adicionales de buses estandarizados y configurables dinámicamente. El límite superior de los tipos de bus admitidos siempre es MaximumBusDataType.

SlotNumber

Para un valor BusDataType de Cmos, especifica la ubicación del dispositivo en el bus. Este parámetro debe ser cero para todos los demás tipos de bus.

[in] Buffer

Puntero a un área de almacenamiento proporcionada por el autor de la llamada con información de configuración específica de BusDataType.

Cuando se especifica PCIConfiguration , el búfer contiene parte o toda la información de PCI_COMMON_CONFIG para el valor de SlotNumber especificado. El desplazamiento y la longitud especificados determinan la cantidad de información proporcionada.

Offset

Especifica el desplazamiento de bytes dentro de la estructura PCI_COMMON_CONFIG en la que comienzan los valores de configuración proporcionados por el autor de la llamada. Un controlador de minipuerto puede usar PCI_COMMON_HDR_LENGTH para especificar el desplazamiento del área específica del dispositivo en PCI_COMMON_CONFIG.

Length

Especifica el número de bytes en buffer.

Valor devuelto

VideoPortSetBusData devuelve el número de bytes de datos establecidos correctamente para el valor de SlotNumber determinado. Si busDataType especificado no es válido para la plataforma actual o si la información proporcionada no es válida, VideoPortSetBusData devuelve cero.

Comentarios

Los controladores de miniporte de adaptadores en un autobús PCI rara vez llaman a VideoPortSetBusData, a menos que circunstancias inusuales o la naturaleza del adaptador de vídeo de un controlador determinado requiera dicha llamada.

Por ejemplo, un controlador de minipuerto podría llamar a VideoPortSetBusData para borrar un poco en el registro de estado PCI si su adaptador señala una anulación de destino durante la inicialización. Si un adaptador de vídeo PCI debe configurarse con datos específicos del dispositivo, su controlador también llama a esta función. En cualquier caso, es probable que este controlador llame a VideoPortGetAccessRanges con un puntero RequestedResources a una matriz proporcionada por el controlador de descriptores de recursos.

No se puede llamar a VideoPortSetBusData desde las funciones HwVidInterrupt o HwVidTimer de un controlador de miniportador, o desde VideoPortQueueDpc, o desde una devolución de llamada a VideoPortSynchronizeExecution.

Requisitos

Consulte también

HalSetBusDataByOffset

HwVidFindAdapter

PCI_COMMON_CONFIG

PCI_SLOT_NUMBER

VideoPortGetAccessRanges

VideoPortGetBusData