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資訊。 指定的 位移 和 長度 決定提供多少資訊。
[in] Offset
指定呼叫端提供的組態值開始之PCI_COMMON_CONFIG結構內的位元組位移。 迷你埠驅動程式可以使用PCI_COMMON_HDR_LENGTH來指定PCI_COMMON_CONFIG中裝置特定區域的位移。
[in] Length
表示要傳回之數據量上限的長度，以位元組為單位。
傳回值
StorPortSetBusDataByOffset 會傳回寫入的組態數據位元組數目。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 標頭 | storport.h （包括 Storport.h） |
| 連結庫 | Storport.lib |