HBA_SendCTPassThruV2 Subroutine

Purpose

Sends a CT request payload.

Syntax

HBA_STATUS HBA_SendCTPassThruV2(
		HBA_HANDLE handle,
		HBA_WWN hbaPortWWN,
		void *pReqBuffer,
		HBA_UINT32 *ReqBufferSize,
		void *pRspBuffer,
		HBA_UINT32 *pRspBufferSize,
);

Description

The HBA_SendCTPassThruV2 function sends a CT request payload. An HBA should decode this CT_IU request by, routing the CT frame in a fabric according to the GS_TYPE field within the CT frame.

Parameters

Item Description
handle A handle to an open HBA through which the CT request is issued.
hbaPortWWN The Port Name for a local HBA Nx_Port through which the CT request is issued.
pReqBuffer Pointer to a buffer containing the full CT payload, including the CT header, to be sent with byte ordering.
ReqBufferSize The size of the full CT payload, including the CT header, in bytes.
pRSPBuffer Pointer to a buffer for the CT response.
pRSPBufferSize Pointer to the size in bytes of the buffer for the CT response payload.

Return Values

The value of the SendCTPassThruV2 function is a valid status return value that indicates the reason for completion of the requested function. HBA_STATUS_OK is returned to indicate that the complete reply to the CT Passthru command has been returned. A valid status return value that most closely describes the result of the function should be returned to indicate a reason with no required value.

The return values for the following parameters are as follows:

Item Description
pRspBuffer Remains unchanged. The buffer to which it points contains the CT response payload, including the CT header received in response to the frame sent, with byte ordering. If the size of the actual response exceeds the size of the response buffer, trailing data is truncated from the response so that the returned data equals the size of the buffer.
pRspBufferSize Remains unchanged. The value of the integer to which it points is set to the size (in bytes) of the actual response data.

Error Codes

Item Description
HBA_STATUS_ERROR_ILLEGAL_WWN The HBA referenced by handle does not contain an Nx_Port with Port Name hbaPortWWN.
HBA_STATUS_ERROR Returned to indicate any problem with no required value.