SendRPS 函数
SendRPS WMI 方法将读取端口状态块 (RPS) 请求发送到指示的端口或域控制器。
语法
void SendRPS(
[out, HBA_STATUS_QUALIFIERS] HBA_STATUS HBAStatus,
[in, HBAType("HBA_WWN")] uint8 PortWWN[8],
[in, HBAType("HBA_WWN")] uint8 AgentWWN[8],
[in, HBAType("HBA_WWN")] uint8 ObjectWWN[8],
[in] uint32 AgentDomain,
[in] uint32 ObjectPortNumber,
[out] uint32 TotalRspBufferSize,
[out] uint32 ActualRspBufferSize,
[out, WmiSizeIs("ActualRspBufferSize")] uint8 RspBuffer[]
);
参数
HBAStatus
返回时，包含操作的状态。 有关允许的值及其说明的列表，请参阅 HBA_STATUS。 微型端口驱动程序在 SendRPS_OUT 结构的 HBAStatus 成员中返回此信息。
PortWWN
用于发送 RPS 命令的本地端口的全球名称。 此信息将传递到 SendRPS_IN 结构的 PortWWN 成员中的微型端口驱动程序。
AgentWWN
要查询 ObjectWWN 指示的端口状态的端口的全球名称。 此信息将传递到 SendRPS_IN 结构的 AgentWWN 成员中的微型端口驱动程序。
ObjectWWN
要为其返回端口状态的端口的全球名称。 此信息将传递到 SendRPS_IN 结构的 ObjectWWN 成员中的微型端口驱动程序。
AgentDomain
要查询的域控制器的域号，以获取 ObjectWWN 指示的端口的状态。 此信息将传递到 SendRPS_IN 结构的 AgentDomain 成员中的微型端口驱动程序。
ObjectPortNumber
要为其返回端口状态的端口的全球名称。 此信息将传递到 SendRPS_IN 结构的 ObjectPortNumber 成员中的微型端口驱动程序。
TotalRspBufferSize
RPS 命令结果的大小（以字节为单位）。 微型端口驱动程序在 SendRPS_OUT 结构的 TotalRspBufferSize 成员中返回此信息。
ActualRspBufferSize
实际检索到的数据的大小（以字节为单位）。 微型端口驱动程序在 SendRPS_OUT 结构的 ActualRspBufferSize 成员中返回此信息。
RspBuffer
RPS 命令的结果。 微型端口驱动程序在 SendRPS_OUT 结构的 RspBuffer 成员中返回此信息。
返回值
不适用于 WMI 方法。
注解
此 WMI 方法属于 MSFC_HBAAdapterMethods WMI 类。
要求
目标平台 |
桌面 |
标头 |
Hbapiwmi.h (包括 Hbapiwmi.h、Hbaapi.h 或 Hbaapi.h) |
库 |
Hbaapi.lib |