Sous-routine HBA_SendCTPassThruV2

Editer en ligne

Objectif

Envoie une charge utile CT.

Syntaxe

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

Descriptif

La fonction HBA_SendCTPassThruV2 envoie une charge de demande CT. Un adaptateur de bus hôte doit décoder cette demande CT_IU en achemine le cadre CT dans une matrice en fonction de la zone TYPE_GROUPE dans le cadre CT.

Paramètres

Article Descriptif
gestionnaire Descripto d'un adaptateur de bus hôte ouvert via lequel la demande CT est émise.
hbaPortWWN Nom de port d'un adaptateur de bus hôte local Port Nx_Port via lequel la demande CT est émise.
pReqBuffer Pointeur vers une mémoire tampon contenant la totalité de la charge CT, y compris l'en-tête CT, à envoyer avec l'ordre des octets.
ReqBufferSize Taille de la charge CT complète, y compris l'en-tête CT, en octets.
pRSPBuffer Pointeur vers une mémoire tampon pour la réponse CT.
pRSPBufferSize Pointeur à la taille en octets de la mémoire tampon pour la charge de la réponse CT.

Valeurs renvoyées

La valeur de la fonction SendCTPassThruV2 est une valeur de retour d'état valide qui indique la raison de l'achèvement de la fonction demandée. HBA_STATUS_OK est renvoyé pour indiquer que la réponse complète à la commande CT Passthru a été renvoyée. Une valeur de retour de statut valide qui décrit le plus précisément le résultat de la fonction doit être renvoyée pour indiquer une raison sans valeur requise.

Les valeurs de retour pour les paramètres suivants sont les suivantes:

Article Descriptif
pRspBuffer Restes inchangés. La mémoire tampon à laquelle il pointe contient la charge de réponse CT, y compris l'en-tête CT reçu en réponse au châssis envoyé, avec ordre des octets. Si la taille de la réponse réelle dépasse la taille de la mémoire tampon de réponse, les données de fin sont tronquées à partir de la réponse de sorte que les données renvoyées correspondent à la taille de la mémoire tampon.
pRspBufferSize Restes inchangés. La valeur de l'entier auquel elle pointe est définie sur la taille (en octets) des données de réponse réelles.

Codes d'erreur

Article Descriptif
HBA_STATUS_ERROR_ILLEGAL_WWN Le HBA référencé par le handle ne contient pas de Nx_Port avec le nom de port hbaPortWWN.
ERREUR HBA_STATUS_ERROR Renvoyé pour indiquer un incident sans valeur requise.