Freigeben über


NDK_FN_INVALIDATE Rückruffunktion (ndkpi.h)

Mit der Funktion NdkInvalidate (NDK_FN_INVALIDATE) wird eine schnell registrierte NDK-Speicherregion (MR) oder ein Speicherfenster (MW) ungültig.

Syntax

NDK_FN_INVALIDATE NdkFnInvalidate;

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

Parameter

[in] pNdkQp

Ein Zeiger auf ein QP-Objekt (NDK-Warteschlangenpaar) (NDK_QP).

[in, optional] RequestContext

Ein Kontextwert, der im RequestContext-Member der NDK_RESULT-Struktur für diese Anforderung zurückgegeben werden soll.

[in] pNdkMrOrMw

Ein Zeiger auf ein Speicherbereichsobjekt (MR) (NDK_MR) oder ein Speicherobjekt (MW) (NDK_MW), das in einer NDK_OBJECT_HEADER-Struktur angegeben ist. Wenn ein MR-Objekt angegeben wird, muss das MR-Objekt bei der Funktion NdkFastRegister (NDK_FN_FAST_REGISTER) registriert worden sein. Der NDK-Consumer darf niemals ein MR-Objekt angeben, das bei der Funktion NdkRegister (NDK_FN_REGISTER) im pNdkMrOrMw-Parameter registriert wurde. Der Zugriff auf MR-Objekte, die mit der Funktion NdkRegister (NDK_FN_REGISTER)) registriert sind, kann mit der Funktion NdkDeregisterMr (NDK_FN_DEREGISTER_MR) entfernt werden.

[in] Flags

Ein bitweiser OR von Flags, der die zulässigen Vorgänge angibt. Die folgenden Flags werden unterstützt:

Wert Bedeutung
NDK_OP_FLAG_SILENT_SUCCESS
0x00000001
Gibt an, dass der erfolgreiche Abschluss dieser Anforderung kein Vervollständigungsereignis in der Warteschlange für ausgehende Vervollständigung generiert. Bei Anforderungen, die fehlschlagen, wird jedoch ein Ereignis in der Vervollständigungswarteschlange generiert.
NDK_OP_FLAG_READ_FENCE
0x00000002
Gibt an, dass alle vorherigen Leseanforderungen abgeschlossen sein müssen, bevor die Hardware mit der Verarbeitung dieser Anforderung beginnt.
NDK_OP_FLAG_DEFER
0x00000200
Gibt dem NDK-Anbieter an, dass er möglicherweise die Anforderung an die Hardware für die Verarbeitung zurückstellen kann. Weitere Informationen zu diesem Flag finden Sie unter NDKPI-Schema für verzögerte Verarbeitung.

Hinweis Dieses Flag wird nur in NDKPI 1.2 (Windows Server 2012 R2) und höher unterstützt.

Rückgabewert

The
Die NdkInvalidate-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode Beschreibung
STATUS_SUCCESS
Die Anforderung wurde erfolgreich gesendet. Ein Vervollständigungseintrag wird in die CQ-Warteschlange eingereiht, wenn die Arbeitsanforderung abgeschlossen ist.
STATUS_CONNECTION_INVALID
Der QP ist nicht verbunden.
Andere status Codes
Ein Fehler ist aufgetreten.

Hinweise

NdkInvalidate ungültig ein NDK-Schnellregister-MR oder MW.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Keine unterstützt, wird in NDIS 6.30 und höher unterstützt.
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile ndkpi.h (include Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Weitere Informationen

Anforderungen an die NDKPI-Vervollständigung

NDKPI-Schema für verzögerte Verarbeitung

Anforderungen an die NDKPI-Veröffentlichung von Arbeitsanforderungen

NDK_FN_DEREGISTER_MR

NDK_FN_FAST_REGISTER

NDK_FN_REGISTER

NDK_MR

NDK_MW

NDK_OBJECT_HEADER

NDK_QP

NDK_RESULT