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

另請參閱

HBA_STATUS

SendRPL_IN

SendRPL_OUT