HalGetBusDataByOffset

9/8/2008

Essa função recupera informações, começando o deslocamento, sobre um slot ou endereço em um barramento E/S.

Syntax

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

Parameters

• BusDataType
  [no] Barramento dados para recuperar. O limite superior em com suporte tipos de barramento é sempre MaximumBusDataType.

• 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 você especificar PCIConfiguration 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 o especificado SlotNumber e função número. Especificado Deslocamento e Comprimento Determinar a quantidade de informações para fornecer. Determinados membros do PCI_COMMON_CONFIG Ter valores somente leitura O chamador é responsável por preservar os valores fornecidos pelo sistema de membros somente leitura.

• Deslocamento
  [no] Deslocamento de byte na PCI_COMMON_CONFIG estrutura para o qual as informações solicitadas devem ser retornadas. Chamadores podem usar a constante System-defined PCI_COMMON_HDR_LENGTH a área especificar a Device-specific de PCI_COMMON_CONFIG.

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

Return Value

Retorna o número de bytes de dados que ele gravou na reserva especificada. Se 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 HalGetBusDataByOffset usa para indicar um erro 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_INVLAID_VENDOR_ID na PCI_COMMON_CONFIG VendorId membro.

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 específicos retornados barramento - tipo - em chamadas posteriores para outra configuração e inicialização funções, como HalTranslateBusAddress.

Quando estiver acessando a área do espaço de configuração PCI, Device-specific HalGetBusDataByOffset Garante que essa função nunca lê ou grava dados fora de intervalo especificado de entrada Deslocamento e Comprimento. Mesmo se a entrada Comprimento é exatamente um 1 - byte ou 2 - byte palavra, essa função nunca acesse quaisquer dados fora de intervalo solicitado.

Requirements

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

See Also

Reference

BUS_DATA_TYPE
HalGetBusData
HalSetBusData
HalSetBusDataByOffset
HalTranslateBusAddress
PCI_COMMON_CONFIG