Função ScsiPortSetBusDataByOffset (srb.h)
O ScsiPortSetBusDataByOffset rotina define dados de configuração de barramento para um adaptador em um barramento de E/S configurável dinamicamente com uma interface padrão publicada.
Sintaxe
SCSIPORT_API ULONG ScsiPortSetBusDataByOffset(
[in] PVOID DeviceExtension,
[in] ULONG BusDataType,
[in] ULONG SystemIoBusNumber,
[in] ULONG SlotNumber,
[in] PVOID Buffer,
[in] ULONG Offset,
[in] ULONG Length
);
Parâmetros
[in] DeviceExtension
Ponteiro para a extensão do dispositivo do driver de miniport.
[in] BusDataType
Contém um valor do tipo BUS_DATA_TYPE que especifica o tipo de dados de barramento a serem definidos. Atualmente, seu valor pode ser PCIConfiguration. No entanto, haverá suporte para tipos adicionais de ônibus padronizados e configuráveis dinamicamente no futuro. O limite superior nos tipos de barramento com suporte é sempre MaximumBusDataType.
[in] SystemIoBusNumber
Especifica o número atribuído pelo sistema do barramento de E/S no qual o HBA está conectado. A rotina de HwScsiFindAdapter do driver de miniporto obtém esse valor do membro PORT_CONFIGURATION_INFORMATION SystemIoBusNumber de entrada.
[in] SlotNumber
Especifica o número de slot lógico do HBA.
Quando PCIConfiguration é especificado como o BusDataType, esse parâmetro deve ser especificado como um valor de tipo PCI_SLOT_NUMBER.
[in] Buffer
Ponteiro para uma área de armazenamento fornecida pelo chamador com informações de configuração específicas para BusDataType.
Quando PCIConfiguration é especificado, o buffer contém algumas ou todas as informações de PCI_COMMON_CONFIG para o de SlotNumber defornecido. O de Deslocamento especificado e Length determinar a quantidade de informações fornecidas.
[in] Offset
Especifica o deslocamento de bytes dentro da estrutura PCI_COMMON_CONFIG na qual os valores de configuração fornecidos pelo chamador começam. Um driver de miniporto pode usar PCI_COMMON_HDR_LENGTH para especificar o deslocamento da área específica do dispositivo em PCI_COMMON_CONFIG.
[in] Length
Especifica o número de bytes na área de armazenamento em buffer.
Valor de retorno
ScsiPortSetBusDataByOffset retorna o número de bytes de dados definidos com êxito para o SlotNumber dedeterminado. Se o BusDataType fornecido não for válido para a plataforma atual ou se as informações fornecidas forem inválidas, ScsiPortSetBusDataByOffset retornará zero.
Observações
Motoristas de miniport de HBAs em um ônibus PCI raramente chamam ScsiPortSetBusDataByOffset a menos que circunstâncias incomuns ou a natureza do HBA de um determinado motorista exija tal chamada. Por exemplo, um driver de miniporto pode chamar ScsiPortSetBusDataByOffset limpar um pouco no registro de status de PCI se o HBA sinalizar uma anulação de destino durante a inicialização ou definir dados de configuração específicos do dispositivo para o HBA.
ScsiPortSetBusDataByOffset só pode ser chamado na rotina HwScsiFindAdapter do driver de miniporto ou no HwScsiAdapterControl quando o tipo de controle é scsiSetRunningConfig.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | srb.h (inclua Miniport.h, Scsi.h) |
| biblioteca | Scsiport.lib |