Função VideoPortGetBusData (video.h)

Artigo
08/07/2023

A função VideoPortGetBusData retorna informações de configuração específicas do tipo de barramento.

Sintaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortGetBusData(
        PVOID         HwDeviceExtension,
        BUS_DATA_TYPE BusDataType,
        ULONG         SlotNumber,
  [out] 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 configuração de barramento a serem retornados. O valor desse parâmetro pode ser Cmos, EisaConfiguration ou PCIConfiguration. No entanto, tipos adicionais de configuração de barramento podem ter suporte no futuro. O limite superior nos tipos com suporte é sempre MaximumBusDataType.

SlotNumber

Especifica o local do dispositivo no barramento para um BusDataTypedo Cmos; zero para todos os outros tipos de barramento.

[out] Buffer

Ponteiro para um buffer no qual VideoPortGetBusData retorna as informações de configuração. O conteúdo do buffer depende do BusDataType, da seguinte maneira:

Se Cmos for especificado, o buffer conterá o conteúdo dos locais CMOS (número de barramento igual a zero) ou ECMOS (número de barramento igual a um), começando com o local especificado para SlotNumber. A função HwVidFindAdapter de um driver de miniport pode determinar o número do barramento do membro SystemIoBusNumber da estrutura de entrada VIDEO_PORT_CONFIG_INFO .
Se EisaConfiguration for especificado, o buffer conterá a estrutura CM_EISA_SLOT_INFORMATION , seguida por zero ou mais estruturas CM_EISA_FUNCTION_INFORMATION para o slot especificado.
Se PCIConfiguration for especificado, o buffer conterá as informações de PCI_COMMON_CONFIG para o slot especificado.

Offset

Especifica o deslocamento, em bytes, para o espaço de configuração PCI que deve ser recuperado se BusDataType for PCIConfiguration; caso contrário, zero. Confira Comentários para obter mais informações.

Length

Especifica o comprimento, em bytes, de Buffer.

Retornar valor

VideoPortGetBusData retorna o número de bytes de informações de configuração que ele escreveu em Buffer. Se o BusDataType especificado não for válido para a plataforma atual, essa função geralmente retornará zero.

Código de retorno	Descrição
0	O barramento PCI não existe.
2	O barramento PCI existe, mas o Buffer contém o valor PCI_INVALID_VENDOR_ID no PCI_COMMON_CONFIG membro VendorId.

Comentários

Para obter apenas uma parte das informações de configuração, o driver de miniporte deve definir Deslocamento para o deslocamento de bytes das informações necessárias e definir Length como o número de bytes das informações necessárias. Por exemplo, se apenas o registro de comando for necessário, defina Deslocamento para o deslocamento desse registro e defina Length como sizeof (USHORT).

O driver deve chamar VideoPortGetAccessRanges em vez de VideoPortGetBusData para recuperar seus recursos de hardware.

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 (inclua Video.h)
Biblioteca	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL