HalSetBusDataByOffset

9/8/2008

Essa função define barramento-dados de configuração para um dispositivo em um dinamicamente configurável barramento E/S com um padrão publicada, interface.

Syntax

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

Parameters

• BusDataType
  [no] Dados de barramento para definir. Este valor pode ser PCIConfiguration. O limite superior em com suporte de tipos está 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 é especificado como 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. 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 onde os valores de configuração Caller-supplied começar. 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 de bytes em Buffer.

Return Value

Retorna o número de bytes de dados definidos com êxito para especificado SlotNumber. Se especificado BusDataType não é válido para o atual plataforma ou se as informações fornecidas está inválido, essa função retorna 0.

Remarks

Um driver pode chamar esta função ou HalSetBusData Se circunstâncias incomuns ou a natureza do seu dispositivo requer tal um chamar. De exemplo, um driver pode chamar um dessas funções para Clear um bit em registrar o status PCI se seu dispositivo assinala uma anular destino durante inicialização. Geralmente, o hardware ou codificar inicialização configura o dispositivo de forma apropriada.

Quando estiver acessando a área do espaço de configuração PCI, Device-specific HalSetBusDataByOffset Garante que essa função nunca lê ou grava dados fora de intervalo especificado de entrada Deslocamento e Comprimento e mesmo se a entrada Comprimento é exatamente um byte ou uma duas-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
HalGetBusDataByOffset
HalSetBusData
HalTranslateBusAddress
PCI_COMMON_CONFIG