共用方式為


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

另請參閱

HW_INITIALIZATION_DATA

StorPortInitialize