ScsiPortSetBusDataByOffset 関数 (srb.h)

[アーティクル]
02/29/2024

ScsiPortSetBusDataByOffset ルーチンは、パブリッシュされた標準インターフェイスを使用して、動的に構成可能な I/O バス上のアダプターのバス構成データを設定します。

メモ SCSI ポートドライバーと SCSI ミニポートドライバーモデルは、今後変更または使用できない可能性があります。代わりに、 Storport ドライバーモデルと Storport ミニポートドライバーモデルを使用することをお勧めします。

構文

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

パラメーター

[in] DeviceExtension

ミニポートドライバーのデバイス拡張機能へのポインター。

[in] BusDataType

設定するバスデータの種類を指定するBUS_DATA_TYPE型の値を格納します。現在、その値は PCIConfiguration にすることができます。ただし、今後、標準化された動的に構成可能なバスの追加の種類がサポートされる予定です。サポートされているバスの種類の上限は常に MaximumBusDataType です。

[in] SystemIoBusNumber

HBA が接続されている I/O バスのシステム割り当て番号を指定します。ミニポートドライバーの HwScsiFindAdapter ルーチンは、 入力PORT_CONFIGURATION_INFORMATION SystemIoBusNumber メンバーからこの値を取得します。

[in] SlotNumber

HBA の論理スロット番号を指定します。

PCIConfiguration をBusDataType として指定する場合は、このパラメーターをPCI_SLOT_NUMBER型の値として指定する必要があります。

[in] Buffer

BusDataType に固有の構成情報を含む、呼び出し元が指定した記憶域へのポインター。

PCIConfiguration を指定すると、バッファーには、指定された SlotNumber のPCI_COMMON_CONFIG情報の一部またはすべてが含まれます。指定した Offset と Length によって、提供される情報の量が決まります。

[in] Offset

呼び出し元指定の構成値が開始されるPCI_COMMON_CONFIG構造体内のバイトオフセットを指定します。ミニポートドライバーは、PCI_COMMON_HDR_LENGTHを使用して、PCI_COMMON_CONFIG内のデバイス固有の領域のオフセットを指定できます。

[in] Length

Buffer の記憶域のバイト数を指定 します。

戻り値

ScsiPortSetBusDataByOffset は、指定された SlotNumber に対して正常に設定されたデータのバイト数を返します。指定された BusDataType が現在のプラットフォームで無効な場合、または指定された情報が無効な場合、 ScsiPortSetBusDataByOffset は 0 を返します。

注釈

PCI バス上の HBA のミニポートドライバーは、通常とは異なる状況や特定のドライバーの HBA の性質がこのような呼び出しを必要とする場合を除き、 ScsiPortSetBusDataByOffset を呼び出すことはほとんどありません。たとえば、ミニポートドライバーは ScsiPortSetBusDataByOffset を呼び出して、初期化中に HBA がターゲットの中止を通知した場合や、HBA のデバイス固有の構成データを設定する場合に、PCI 状態レジスタのビットをクリアする場合があります。

ScsiPortSetBusDataByOffset は、ミニポートドライバーの HwScsiFindAdapter ルーチンから、またはコントロールの種類が ScsiSetRunningConfig の場合は HwScsiAdapterControl からのみ呼び出すことができます。