Função VideoPortSetBusData (video.h)
A função VideoPortSetBusData define dados de configuração de barramento para um adaptador em um barramento de E/S configurável dinamicamente com uma interface padrão publicada.
Sintaxe
VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortSetBusData(
PVOID HwDeviceExtension,
BUS_DATA_TYPE BusDataType,
ULONG SlotNumber,
[in] PVOID Buffer,
ULONG Offset,
ULONG Length
);
Parâmetros
HwDeviceExtension
Ponteiro para a extensão de dispositivo do driver de miniport.
BusDataType
Especifica o tipo de dados de barramento a serem definidos. Atualmente, seu valor pode ser um de Cmos, EisaConfiguration ou PCIConfiguration. No entanto, outros tipos de barramentos padronizados e configuráveis dinamicamente poderão ter suporte no futuro. O limite superior nos tipos de barramento com suporte é sempre MaximumBusDataType.
SlotNumber
Para um valor BusDataType de Cmos, especifica o local do dispositivo no barramento. Esse parâmetro deve ser zero para todos os outros tipos de barramento.
[in] Buffer
Ponteiro para uma área de armazenamento fornecida pelo chamador com informações de configuração específicas para BusDataType.
Quando PCIConfiguration é especificado, o buffer contém algumas ou todas as informações de PCI_COMMON_CONFIG para o SlotNumber fornecido. O Deslocamento e o Comprimento especificados determinam quantas informações são fornecidas.
Offset
Especifica o deslocamento de bytes dentro da estrutura PCI_COMMON_CONFIG na qual os valores de configuração fornecidos pelo chamador começam. Um driver de miniporta pode usar PCI_COMMON_HDR_LENGTH para especificar o deslocamento da área específica do dispositivo em PCI_COMMON_CONFIG.
Length
Especifica o número de bytes no Buffer.
Retornar valor
VideoPortSetBusData retorna o número de bytes de dados definidos com êxito para o SlotNumber especificado. Se o BusDataType fornecido não for válido para a plataforma atual ou se as informações fornecidas forem inválidas, VideoPortSetBusData retornará zero.
Comentários
Drivers de miniporta de adaptadores em um barramento PCI raramente chamam VideoPortSetBusData, a menos que circunstâncias incomuns ou a natureza do adaptador de vídeo de um determinado driver exija tal chamada.
Por exemplo, um driver de miniporto pode chamar VideoPortSetBusData para limpar um pouco no registro de status PCI se o adaptador sinalizar uma anulação de destino durante a inicialização. Se um adaptador de vídeo PCI precisar ser configurado com dados específicos do dispositivo, seu driver também chamará essa função. Em ambos os casos, esse driver provavelmente chamará VideoPortGetAccessRanges com um ponteiro RequestedResources para uma matriz de descritores de recursos fornecida pelo driver.
VideoPortSetBusData não pode ser chamado das funções HwVidInterrupt ou HwVidTimer de um driver de miniport, ou de VideoPortQueueDpc, ou de um retorno de chamada para VideoPortSynchronizeExecution.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | video.h (incluir Video.h) |
| Biblioteca | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |