Função StorPortSetBusDataByOffset (storport.h)

Artigo
02/07/2025

A rotina StorPortSetBusDataByOffset grava informações de configuração específicas do barramento.

Sintaxe

STORPORT_API ULONG StorPortSetBusDataByOffset(
  [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 área de armazenamento por HBA do driver de miniporto.

[in] BusDataType

Contém um valor do tipo BUS_DATA_TYPE que especifica o tipo do barramento para o qual as informações de configuração devem ser gravadas. 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 HwStorFindAdapter do driver de miniporto obtém esse valor do membroSystemIoBusNumber do PORT_CONFIGURATION_INFORMATION de entrada.

[in] SlotNumber

Indica 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

Indica o comprimento, em bytes, da quantidade máxima de dados a serem retornados.

Valor de retorno

StorPortSetBusDataByOffset retorna o número de bytes de dados de configuração gravados.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	storport.h (inclua Storport.h)
biblioteca	Storport.lib

Consulte também

ScsiPortSetBusDataByOffset

Partilhar via