Lire en anglais

Partager via


NDK_FN_SEND fonction de rappel (ndkpi.h)

La fonction NdkSend (NDK_FN_SEND) publie une demande d’envoi sur une paire de files d’attente NDK (QP).

Syntaxe

NDK_FN_SEND NdkFnSend;

NTSTATUS NdkFnSend(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
                 const NDK_SGE *pSgl,
  [in]           ULONG nSge,
  [in]           ULONG Flags
)
{...}

Paramètres

[in] pNdkQp

Pointeur vers un objet de paire de files d’attente NDK (QP) (NDK_QP).

[in, optional] RequestContext

Valeur de contexte à retourner dans le membre RequestContext de la structure NDK_RESULT pour cette requête.

pSgl

Tableau de structures SGE (NDK_SGE) qui représentent les mémoires tampons contenant les données à envoyer.

[in] nSge

Nombre de structures SGE dans le tableau spécifié dans le paramètre pSgl .

[in] Flags

Or au niveau du bit des indicateurs qui spécifie les opérations autorisées. Les indicateurs suivants sont pris en charge :

Valeur Signification
NDK_OP_FLAG_SILENT_SUCCESS
0x00000001
Indique que la réussite de cette demande ne génère pas d’événement d’achèvement dans la file d’attente d’achèvement sortante. Toutefois, les demandes qui échouent génèrent un événement dans la file d’attente d’achèvement.
NDK_OP_FLAG_READ_FENCE
0x00000002
Indique que toutes les demandes de lecture antérieures doivent être terminées avant que le matériel ne commence à traiter cette demande.
NDK_OP_FLAG_SEND_AND_SOLICIT_EVENT
0x00000004
Indique que la file d’attente d’achèvement pour l’homologue génère une notification. Pour plus d’informations sur NDK_OP_FLAG_SEND_AND_SOLICIT_EVENT, consultez la section Remarques.
NDK_OP_FLAG_INLINE
0x00000040
Indique que la mémoire référencée par les SGE doit être transférée inline. En outre, la valeur MemoryRegionToken dans les entrées NDK_SGE peut être non valide. Les requêtes inline n’ont pas besoin de limiter le nombre d’entrées dans la liste SGE à la valeur MaxInitiatorRequestSge spécifiée lors de la création de la paire de file d’attente. La quantité de mémoire transférée inline doit se trouver dans les limites de données inline de la paire file d’attente.
NDK_OP_FLAG_DEFER
0x00000200
Indique au fournisseur NDK qu’il peut différer l’indication de la demande au matériel pour traitement. Pour plus d’informations sur cet indicateur, consultez Schéma de traitement différé NDKPI.

Note Cet indicateur est pris en charge uniquement dans NDKPI 1.2 (Windows Server 2012 R2) et versions ultérieures.

Valeur retournée

La fonction NdkSend retourne l’un des codes NTSTATUS suivants.

Code de retour Description
STATUS_SUCCESS
La demande d’envoi a été publiée avec succès. Une entrée d’achèvement est mise en file d’attente vers la file d’attente d’achèvement (CQ) une fois la demande de travail terminée.
STATUS_CONNECTION_INVALID
La paire de files d’attente (QP) n’est pas connectée.
Autres codes status
Une erreur est survenue.

Remarques

NdkSend publie une demande d’envoi sur une paire de files d’attente (QP).

Vous pouvez utiliser l’indicateur NDK_OP_FLAG_SEND_AND_SOLICIT_EVENT si vous émettez plusieurs demandes d’envoi associées. Définissez cet indicateur sur la dernière requête du groupe de demandes d’envoi associées.

Un consommateur NDK peut utiliser cet indicateur lors de l’émission de plusieurs demandes d’envoi associées. Le consommateur NDK définit cet indicateur uniquement sur la dernière demande d’envoi associée. L’homologue reçoit toutes les demandes d’envoi comme d’habitude. Toutefois, lorsque l’homologue reçoit la dernière demande d’envoi (la demande avec l’indicateur NDK_OP_FLAG_SEND_AND_SOLICIT_EVENT défini), la file d’attente d’achèvement pour l’homologue génère une notification. La notification est générée une fois la demande de réception terminée. Cet indicateur n’a aucune signification pour le récepteur (homologue), sauf si le récepteur a précédemment appelé la fonction NdkArmCq (NDK_FN_ARM_CQ) avec le type de notification défini sur NDK_CQ_NOTIFY_SOLICITED.

Note Les demandes qui se terminent par une erreur correspondent toujours au type de notification NDK_CQ_NOTIFY_SOLICITED .
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge, pris en charge dans NDIS 6.30 et versions ultérieures.
Serveur minimal pris en charge Windows Server 2012
Plateforme cible Windows
En-tête ndkpi.h (inclure Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Voir aussi

Schéma de traitement différé NDKPI

Exigences de publication de demande de travail NDKPI

NDK_FN_ARM_CQ

NDK_QP

NDK_RESULT

NDK_SGE