NDK_FN_WRITE fonction de rappel (ndkpi.h)

Article
02/07/2025

La fonction NdkWrite (NDK_FN_WRITE) publie une demande d’écriture sur une paire de files d’attente NDK (QP).

Syntaxe

NDK_FN_WRITE NdkFnWrite;

NTSTATUS NdkFnWrite(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
                 const NDK_SGE *pSgl,
  [in]           ULONG nSge,
  [in]           UINT64 RemoteAddress,
  [in]           UINT32 RemoteToken,
  [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 à renvoyer 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 à écrire.

[in] nSge

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

[in] RemoteAddress

Adresse distante à écrire, fournie dans l’ordre d’octet de l’hôte local. Le consommateur NDK peut avoir ajouté un décalage à la valeur fournie à distance.

[in] RemoteToken

Jeton de mémoire fourni à distance, tableau opaque d’octets du consommateur NDK.

[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 la réussite de cette requête, mais 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 une fin 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 commence à traiter cette demande.
NDK_OP_FLAG_DEFER 0x00000200	Indique au fournisseur NDK qu’il peut différer la demande au matériel pour traitement. Pour plus d’informations sur cet indicateur, consultez schéma de traitement différé NDKPI. Remarque Cet indicateur est pris en charge uniquement dans NDKPI 1.2 (Windows Server 2012 R2) et versions ultérieures.

Valeur de retour

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

Retourner le code	Description
STATUS_SUCCESS	La demande 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) lorsque la demande de travail est terminée.
STATUS_CONNECTION_INVALID	La paire de files d’attente (QP) n’est pas connectée.
Autres codes d’état	Une erreur s’est produite.

Remarques

NdkWrite publie une demande d’écriture sur une paire de files d’attente (QP).

Exigences

Exigence	Valeur
client minimum pris en charge	Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Windows
d’en-tête	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Voir aussi

schéma de traitement différé NDKPI

exigences de publication des demandes de travail NDKPI

NDK_QP

NDK_RESULT

NDK_SGE

Partager via