HalGetBusData

9/8/2008

Essa função recupera informações sobre um slot especificado ou endereço configuração em um barramento E/S.

Syntax

ULONG HalGetBusData( 
  BUS_DATA_TYPE BusDataType, 
  ULONG BusNumber, 
  ULONG SlotNumber, 
  PVOID Buffer, 
  ULONG Length 
);

Parameters

• BusDataType
  [no] Tipo de barramento dados a serem recuperados. O limite superior em com suporte de tipos está sempre MaximumBusDataType a partir de BUS_DATA_TYPE enumeração. Implementação do barramento rotinas é específico do OEM. O usar como padrão CEDDK.dll retorna 0 para essa função. O CEDDK.dll para um CEPC oferece suporte a configurações barramento PNPISAConfiguration e PCIConfiguration.

• BusNumber
  [no] Número base zero e System-Assigned do barramento em sistemas com diversos barramentos do mesmo BusDataType.

• SlotNumber
  [no] Número lógico slot ou localidade do dispositivo. Se PCIConfiguration for especificada como o BusDataType, esse valor um valor PCI_SLOT_NUMBER, que é o número slot e função combinado.

• Buffer
  [no] Ponteiro para uma reserva Caller-supplied para configuração informações específicas para BusDataType. Se você especificar PCIConfiguration, a reserva contém o PCI_COMMON_CONFIG informações para especificado SlotNumber e função número.

• Comprimento
  [no] Número máximo de bytes a retornar Buffer.

Return Value

Retorna o número de bytes de dados que ele gravou na reserva especificada. Se o especificado BusDataType não é válido para o atual plataforma, essa função retorna 0.

A seguinte tabela mostra os valores de retorno para esta função que indicam erros quando a entrada BusType é PCIConfiguration.

Valor	Descrição
0	O barramento PCI especificado não existe.
2	O barramento PCI especificado existe, mas não há nenhum dispositivo no PCI especificado SlotNumber. O Buffer Também contém o valor PCI_INVALID_VENDOR_ID para a VendorId membro de PCI_COMMON_CONFIG.

Remarks

Chamar drivers de dispositivo essa função durante inicialização para localizar seus dispositivos em um barramento E/S específico. Você pode usar o dados de configuração retornada, que é específicas para tipo de barramento, em chamadas posteriores para outra configuração e inicialização funções, como HalTranslateBusAddress.

Para com suporte barramentos, HalGetBusData Chamadas HalGetBusDataByOffset Com um Deslocamento de 0, que recupera informações configuração para o dispositivo começando em Deslocamento 0.

Requirements

Header	ceddk.h
Library	CEDDK.lib
Windows Embedded CE	Windows CE 2.10 and later

See Also

Reference

BUS_DATA_TYPE
HalGetBusDataByOffset
HalSetBusData
HalSetBusDataByOffset
HalTranslateBusAddress
PCI_COMMON_CONFIG