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 do dispositivo do driver de miniport.
BusDataType
Especifica o tipo de dados de ônibus a serem definidos. Atualmente, seu valor pode ser um dos Cmos, EisaConfigurationou PCIConfiguration. No entanto, tipos adicionais de ônibus padronizados e configuráveis dinamicamente podem ter suporte no futuro. O limite superior nos tipos de barramento com suporte é sempre MaximumBusDataType.
SlotNumber
Para um valor BusDataType de Cmos, especifica a localização do dispositivo no barramento. Esse parâmetro deve ser zero para todos os outros tipos de ônibus.
[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 de SlotNumber defornecido. O de Deslocamento especificado e Length determinar a quantidade de informações 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 miniporto 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 em buffer.
Valor de retorno
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.
Observações
Motoristas de miniportuários de adaptadores em um ônibus PCI raramente chamam VideoPortSetBusData, a menos que circunstâncias incomuns ou a natureza do adaptador de vídeo de um determinado motorista exija tal chamada.
Por exemplo, um driver de miniporto pode chamar VideoPortSetBusData para limpar um pouco no registro de status de 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 de funções HwVidInterrupt ou HwVidTimer de um driver de miniport, ou de VideoPortQueueDpc, ou de um retorno de chamada para VideoPortSynchronizeExecution .
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | video.h (inclua Video.h) |
| biblioteca | Videoprt.lib |
| de DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |