Funzione ScsiPortSetBusDataByOffset (srb.h)

Articolo
02/07/2025

Il ScsiPortSetBusDataByOffset routine imposta i dati di configurazione del bus per un adattatore in un bus di I/O configurabile dinamicamente con un'interfaccia standard pubblicata.

Nota I modelli di driver porta SCSI e miniport SCSI potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare driver Storport e modelli di driver miniport Storport.

Sintassi

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
);

Parametri

[in] DeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] BusDataType

Contiene un valore di tipo BUS_DATA_TYPE che specifica il tipo di dati del bus da impostare. Attualmente, il valore può essere PCIConfiguration. Tuttavia, in futuro saranno supportati altri tipi di bus standardizzati e configurabili dinamicamente. Il limite superiore sui tipi di bus supportati è sempre MaximumBusDataType.

[in] SystemIoBusNumber

Specifica il numero assegnato dal sistema del bus di I/O in cui è connesso l'HBA. La routine HwScsiFindAda pter del driver miniport ottiene questo valore dal membro PORT_CONFIGURATION_INFORMATION SystemIoBusNumber di input.

[in] SlotNumber

Specifica il numero di slot logico dell'HBA.

Quando PCIConfiguration viene specificato come BusDataType, questo parametro deve essere specificato come valore di tipo PCI_SLOT_NUMBER.

[in] Buffer

Puntatore a un'area di archiviazione fornita dal chiamante con informazioni di configurazione specifiche per BusDataType.

Quando si specifica PCIConfiguration, il buffer contiene alcune o tutte le informazioni di PCI_COMMON_CONFIG per l'SlotNumber specificato. Il offset specificato e Lunghezza determinare la quantità di informazioni fornite.

[in] Offset

Specifica l'offset di byte all'interno della struttura PCI_COMMON_CONFIG in corrispondenza della quale iniziano i valori di configurazione forniti dal chiamante. Un driver miniport può usare PCI_COMMON_HDR_LENGTH per specificare l'offset dell'area specifica del dispositivo in PCI_COMMON_CONFIG.

[in] Length

Specifica il numero di byte nell'area di archiviazione in Buffer.

Valore restituito

ScsiPortSetBusDataByOffset restituisce il numero di byte di dati impostati correttamente per l'SlotNumber specificato. Se la busDataType specificata non è valida per la piattaforma corrente o se le informazioni fornite non sono valide, ScsiPortSetBusDataByOffset restituisce zero.

Osservazioni

I driver miniport di HBA su un bus PCI raramente chiamano ScsiPortSetBusDataByOffset a meno che circostanze insolite o la natura dell'HBA di un determinato driver richieda una chiamata di questo tipo. Ad esempio, un driver miniport potrebbe chiamare ScsiPortSetBusDataByOffset per cancellare un bit nel registro di stato PCI se l'HBA segnala un'interruzione di destinazione durante l'inizializzazione o per impostare i dati di configurazione specifici del dispositivo per l'HBA.

ScsiPortSetBusDataByOffset può essere chiamato solo dalla routine del driver miniport HwScsiFindAdapter o da HwScsiAdapterControl quando il tipo di controllo è ScsiSetRunningConfig.