NDK_FN_INVALIDATE funzione di callback (ndkpi.h)

Articolo
02/07/2025

La funzione NdkInvalidate (NDK_FN_INVALIDATE) Invalida un'area di memoria NDK con registrazione rapida (MR) o una finestra di memoria (MW).

Sintassi

NDK_FN_INVALIDATE NdkFnInvalidate;

NTSTATUS NdkFnInvalidate(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
  [in]           NDK_OBJECT_HEADER *pNdkMrOrMw,
  [in]           ULONG Flags
)
{...}

Parametri

[in] pNdkQp

Puntatore a un oggetto QP (NDK Queue Pair) (NDK_QP).

[in, optional] RequestContext

Valore di contesto da restituire nel membro RequestContext della struttura NDK_RESULT per questa richiesta.

[in] pNdkMrOrMw

Puntatore a un oggetto area di memoria (MR) (NDK_MR) o a un oggetto memoria (MW) (NDK_MW) specificato in una struttura di NDK_OBJECT_HEADER. Se viene specificato un oggetto MR, l'oggetto MR deve essere stato registrato con la funzione NdkFastRegister (NDK_FN_FAST_REGISTER). Il consumer NDK non deve mai specificare un oggetto MR registrato con la funzione NdkRegister (NDK_FN_REGISTER) nel parametro pNdkMrOrMw. È possibile rimuovere l'accesso agli oggetti MR registrati con la funzione NdkRegister (NDK_FN_REGISTER)) con la funzione NdkDeregisterMr (NDK_FN_DEREGISTER_MR).

[in] Flags

OR bit per bit di flag che specifica le operazioni consentite. Sono supportati i flag seguenti:

Valore	Significato
NDK_OP_FLAG_SILENT_SUCCESS 0x00000001	Indica che il completamento di questa richiesta non genera un evento di completamento nella coda di completamento in uscita. Tuttavia, le richieste che non riescono generano un evento nella coda di completamento.
NDK_OP_FLAG_READ_FENCE 0x00000002	Indica che tutte le richieste di lettura precedenti devono essere completate prima che l'hardware inizi l'elaborazione di questa richiesta.
NDK_OP_FLAG_DEFER 0x00000200	Indica al provider NDK che può rinviare la richiesta all'hardware per l'elaborazione. Per altre informazioni su questo flag, vedere schema di elaborazione posticipato NDKPI. Nota Questo flag è supportato solo in NDKPI 1.2 (Windows Server 2012 R2) e versioni successive.

Valore restituito

Le
funzione NdkInvalidate restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La richiesta è stata inviata correttamente. Una voce di completamento verrà accodata al CQ al termine della richiesta di lavoro.
STATUS_CONNECTION_INVALID	QP non è connesso.
Altri codici di stato	Si è verificato un errore.

Osservazioni

NdkInvalidate invalida un MR o MW con registrazione rapida NDK.

Fabbisogno

Requisito	Valore
client minimo supportato	Nessuna supportata, supportata in NDIS 6.30 e versioni successive.
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Finestre
intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL