SendRPL 函式
SendRPL WMI 方法會透過指定的埠傳送讀取埠清單， (RPL) 命令傳送至指定的目的地埠。
語法
void SendRPL(
[out, HBA_STATUS_QUALIFIERS] HBA_STATUS HBAStatus,
[in, HBAType("HBA_WWN")] uint8 PortWWN[8],
[in, HBAType("HBA_WWN")] uint8 AgentWWN[8],
[in] uint32 agent_domain,
[in] uint32 portIndex,
[out] uint32 TotalRspBufferSize,
[out] uint32 ActualRspBufferSize,
[out, WmiSizeIs("ActualRspBufferSize")] uint8 RspBuffer[]
);
參數
HBAStatus
傳回時，包含作業的狀態。 如需允許值及其描述的清單，請參閱 HBA_STATUS。 迷你埠驅動程式會在 SendRPL_OUT 結構的 HBAStatus 成員中傳回這項資訊。
PortWWN
傳送讀取埠清單 (RPL) 命令的本機埠全球名稱。 此資訊會傳遞至 SendRPL_IN 結構的 PortWWN 成員中的迷你埠驅動程式。
AgentWWN
要查詢之埠的全球名稱，以取得類型為 FC_Port 的埠清單。 如需FC_Port的定義，請參閱 T11 委員會的 光纖通道 HBA API 規格。 此資訊會傳遞至 SendRPL_IN 結構的 AgentWWN 成員中的迷你埠驅動程式。
agent_domain
要查詢之域控制器的網域號碼，以取得類型為 FC_Port 的埠清單。 如需FC_Port的定義，請參閱 T11 委員會的 光纖通道 HBA API 規格。 此資訊會傳遞至SendRPL_IN結構agent_domain成員中的迷你埠驅動程式。
portIndex
要傳回之埠清單中第一個埠的埠索引FC_Port。 此資訊會傳遞至 SendRPL_IN 結構的 portIndex 成員中的miniport驅動程式。
TotalRspBufferSize
讀取埠清單結果的大小以位元組為單位， (RPL) 命令。 迷你埠驅動程式會在 SendRPL_OUT 結構的 TotalRspBufferSize 成員中傳回這項資訊。
ActualRspBufferSize
實際擷取之數據的位元元組大小。 迷你埠驅動程式會在 SendRPL_OUT 結構的 ActualRspBufferSize 成員中傳回這項資訊。
RspBuffer
讀取埠清單的結果 (RPL) 命令。 迷你埠驅動程式會在 SendRPL_OUT 結構的 RspBuffer 成員中傳回這項資訊。
傳回值
不適用於 WMI 方法。
備註
這個 WMI 方法屬於 MSFC_HBAAdapterMethods WMI 類別。
規格需求
目標平台 |
桌面 |
標頭 |
Hbapiwmi.h (包括 Hbapiwmi.h、Hbaapi.h 或 Hbaapi.h) |
媒體櫃 |
Hbaapi.lib |