storPortSetBusDataByOffset 函式 (storport.h)
StorPortSetBusDataByOffset 例程會寫入總線特定的組態資訊。
語法
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
);
參數
[in] DeviceExtension
迷你埠驅動程式每個 HBA 儲存區域的指標。
[in] BusDataType
包含類型 為 BUS_DATA_TYPE 的值，指定要寫入組態資訊之總線的類型。 目前，其值可以是 PCIConfiguration。 不過，未來將支援其他標準化且可動態設定的總線類型。 支援的總線類型上限一律為 MaximumBusDataType。
[in] SystemIoBusNumber
指定 HBA 所連接之 I/O 總線的系統指派號碼。 迷你埠驅動程式的 HwStorFindAdapter 例程會從輸入 PORT_CONFIGURATION_INFORMATIONSystemIoBusNumber 成員取得此值。
[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
表示要傳回的最大數據量長度，以位元組為單位。
傳回值
StorPortSetBusDataByOffset 會傳回寫入之組態數據的位元元組數目。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | storport.h (包含 Storport.h) |
| 程式庫 | Storport.lib |