Sends a CT request payload.
HBA_STATUS HBA_SendCTPassThruV2(
HBA_HANDLE handle,
HBA_WWN hbaPortWWN,
void *pReqBuffer,
HBA_UINT32 *ReqBufferSize,
void *pRspBuffer,
HBA_UINT32 *pRspBufferSize,
);
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.
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. |
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. |
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. |