StorPortGetSystemAddress 函式 (storport.h)
StorPortGetSystemAddress 例程會針對指定之 SCSI 要求區塊的數據緩衝區傳回系統空間中的虛擬位址, (SRB) 。
語法
ULONG StorPortGetSystemAddress(
[in] PVOID HwDeviceExtension,
[in] PSCSI_REQUEST_BLOCK Srb,
[out] PVOID *SystemAddress
);
參數
[in] HwDeviceExtension
主機總線適配卡的硬體裝置擴充功能指標, (HBA) 。
[in] Srb
SCSI_REQUEST_BLOCK 結構的指標。
[out] SystemAddress
接收數據緩衝區虛擬位址的指標。
傳回值
StorPortGetSystemAddress 會傳回下列其中一個狀態代碼:
傳回碼 | Description |
---|---|
|
此函式不會在作用中的操作系統上實作。 |
|
表示已成功取得系統位址。 |
|
此狀態代碼是由下列其中一個條件所造成:
SRB 沒有相關聯的數據緩衝區。 接收虛擬位址的指標為 NULL。 |
|
呼叫是在無效的 IRQL 進行。 |
|
嘗試將數據緩衝區對應至系統空間失敗。 |
備註
從 Windows 8 開始,Srb 參數可能會指向SCSI_REQUEST_BLOCK或STORAGE_REQUEST_BLOCK。 如果 Srb的函式欄位中的函式識別碼是SRB_FUNCTION_STORAGE_REQUEST_BLOCK,SRB 是STORAGE_REQUEST_BLOCK要求結構。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows Server 2003 SP2 開始,即可使用此例程。 |
目標平台 | Universal |
標頭 | storport.h (包含 Storport.h) |
IRQL | <=DISPATCH_LEVEL |
DDI 合規性規則 | StorPortIrql (storport) |