StorPortGetLogicalUnit 函式 (storport.h)
StorPortGetLogicalUnit 例程會傳回迷你埠驅動程式每個邏輯單元儲存區域的指標。
語法
STORPORT_API PVOID StorPortGetLogicalUnit(
[in] PVOID HwDeviceExtension,
[in] UCHAR PathId,
[in] UCHAR TargetId,
[in] UCHAR Lun
);
參數
[in] HwDeviceExtension
硬體裝置延伸模組的指標。 這是埠驅動程式代表迷你埠驅動程式配置和初始化的每個 HBA 儲存區域。 迷你埠驅動程式通常會在此延伸模組中儲存 HBA 特定資訊,例如 HBA 的狀態和 HBA 的對應存取範圍。 只要呼叫迷你埠驅動程式的 HwStorFindAdapter 例程,此區域即可供迷你埠驅動程式使用。 埠驅動程式會在移除裝置時釋放此記憶體。
[in] PathId
識別 SCSI 總線。
[in] TargetId
識別總線上的目標控制器或裝置。
[in] Lun
識別目標裝置的邏輯單元 (LU) 編號。
傳回值
StorPortGetLogicalUnit 會針對要求的邏輯單元傳回迷你埠驅動程式儲存區域的指標。 如果邏輯單元不存在,則會 NULL傳回 。
言論
如果迷你埠驅動程式的 DriverEntry 例程在呼叫 StorPortInitialize時,LuExtensionSizeHW_INITIALIZATION_DATAStorPortGetLogicalUnit 無關。 否則,作系統特定的埠驅動程式會以零來配置和初始化,並使用一組指定大小的 LU 擴充功能,供迷你埠驅動程式使用。
Per-LU 記憶體可用來儲存與特定周邊相關的數據,例如已儲存的數據指標。 若要存取此區域,迷你埠驅動程式會呼叫 StorPortGetLogicalUnit 驅動程式維護任何特定外圍設備的狀態或目前作業的相關信息。
如果該邏輯單元沒有作用中要求且從未成功選取裝置,作系統特定的埠驅動程式可以將邏輯單元視為不存在。
注意
當迷你埠驅動程式在 IRQL = DISPATCH_LEVEL 呼叫 StorPortGetLogicalUnit 時,函式會取得中斷鎖定。 在此 IRQL 層級呼叫 StorPortGetLogicalUnit,會影響迷你埠驅動程式的效能和延展性。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows XP 和更新版本的 Windows作系統。 |
目標平臺 | 普遍 |
標頭 | storport.h (包括 Storport.h) |
連結庫 | Storport.lib |