Función VideoPortSetBusData (video.h)
La función VideoPortSetBusData establece datos de configuración de bus para un adaptador en un bus de E/S configurable dinámicamente con una interfaz estándar publicada.
VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortSetBusData(
PVOID HwDeviceExtension,
BUS_DATA_TYPE BusDataType,
ULONG SlotNumber,
[in] PVOID Buffer,
ULONG Offset,
ULONG Length
);
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 uno de Cmos, EisaConfigurationo PCIConfiguration. Sin embargo, es posible que se admita en el futuro otros 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 de 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 slotNumber especificado. El de desplazamiento especificado y longitud determinar 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 miniport 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 Búfer.
VideoPortSetBusData devuelve el número de bytes de datos establecidos correctamente para el slotNumber especificado. Si el busDataType especificado no es válido para la plataforma actual o si la información proporcionada no es válida, VideoPortSetBusData devuelve cero.
Los controladores de miniporte de adaptadores en un bus 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 RequestedResources puntero a una matriz proporcionada por controladores de descriptores de recursos.
videoPortSetBusData no se puede llamar desde las funciones de HwVidInterrupt o HwVidTimer o desde VideoPortQueueDpc, o desde una devolución de llamada a VideoPortSynchronizeExecution.
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 |