NDK_FN_INVALIDATE fonction de rappel (ndkpi.h)

Article
03/05/2024

La fonction NdkInvalidate (NDK_FN_INVALIDATE) invalide une région de mémoire NDK (MR) à inscription rapide ou une fenêtre mémoire (MW).

Syntaxe

NDK_FN_INVALIDATE NdkFnInvalidate;

NTSTATUS NdkFnInvalidate(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
  [in]           NDK_OBJECT_HEADER *pNdkMrOrMw,
  [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.

[in] pNdkMrOrMw

Pointeur vers un objet de région de mémoire (MR) (NDK_MR) ou un objet de mémoire (MW) (NDK_MW) spécifié dans une structure de NDK_OBJECT_HEADER . Si un objet MR est spécifié, l’objet MR doit avoir été inscrit auprès de la fonction NdkFastRegister (NDK_FN_FAST_REGISTER). Le consommateur NDK ne doit jamais spécifier un objet MR inscrit auprès de la fonction NdkRegister (NDK_FN_REGISTER) dans le paramètre pNdkMrOrMw . L’accès aux objets MR inscrits avec la fonction NdkRegister (NDK_FN_REGISTER)) peut être supprimé avec la fonction NdkDeregisterMr (NDK_FN_DEREGISTER_MR).

[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_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

The
La fonction NdkInvalidate retourne l’un des codes NTSTATUS suivants.

Code de retour	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 le CQ une fois la demande de travail terminée.
STATUS_CONNECTION_INVALID	Le QP n’est pas connecté.
Autres codes status	Une erreur est survenue.

Remarques

NdkInvalidate invalide un NDK fast-register MR ou MW.

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