SendLIRR function

The SendLIRR WMI method sends a link incident record registration (LIRR) command through the indicated local port to the indicated remote port.

Syntax

void SendLIRR(
   [out, HBA_STATUS_QUALIFIERS] HBA_STATUS       HBAStatus,
   [in, HBAType("HBA_WWN")] uint8                SourceWWN[8],
   [in, HBAType("HBA_WWN")] uint8                DestWWN[8],
   [in] uint8                                    Function,
   [in] uint8                                    Type,
   [out] uint32                                  TotalRspBufferSize,
   [out] uint32                                  ActualRspBufferSize,
   [out, WmiSizeIs("ActualRspBufferSize")] uint8 RspBuffer[]
);

Parameters

HBAStatus
On return, contains the status of the operation. For a list of allowed values and their descriptions, see HBA_STATUS. The miniport driver returns this information in the HBAStatus member of a SendLIRR_OUT structure.

SourceWWN
A worldwide name for the local port through which the LIRR command is sent. This information is delivered to the miniport driver in the SourceWWN member of a SendLIRR_IN structure.

DestWWN
A worldwide name for the destination port. This information is delivered to the miniport driver in the DestWWN member of a SendLIRR_IN structure.

Function
The code that identifies which registration function is to be performed. For an explanation of which values can be assigned to this member, see the T11 committee's Fibre Channel Framing and Signaling specification. This information is delivered to the miniport driver in the Function member of a SendLIRR_IN structure.

Type
The device type for which link information is requested. For an explanation of which values can be assigned to this member, see the T11 committee's Fibre Channel Framing and Signaling specification. This information is delivered to the miniport driver in the Function member of a SendLIRR_IN structure.

TotalRspBufferSize
The size in bytes of the results of the LIRR command. The miniport driver returns this information in the TotalRspBufferSize member of a SendLIRR_OUT structure.

ActualRspBufferSize
The size in bytes of the data that was actually retrieved. The miniport driver returns this information in the ActualRspBufferSize member of a SendLIRR_OUT structure.

RspBuffer
The results of the LIRR command. The miniport driver returns this information in the RspBuffer member of a SendLIRR_OUT structure.

Return value

Not applicable to WMI methods.

Remarks

This WMI method belongs to the MSFC_HBAAdapterMethods WMI Class.

Requirements

Target platform

Desktop

Header

Hbapiwmi.h (include Hbapiwmi.h, Hbaapi.h, or Hbaapi.h)

Library

Hbaapi.lib

See also

HBA_STATUS

SendLIRR_IN

SendLIRR_OUT