Função VideoPortGetBusData (video.h)
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 |