NDK_FN_WRITE Rückruffunktion (ndkpi.h)

Artikel
02/07/2025

Die NdkWrite (NDK_FN_WRITE) stellt eine Schreibanforderung für ein NDK-Warteschlangenpaar (QP) dar.

Syntax

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
)
{...}

Parameter

[in] pNdkQp

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

[in, optional] RequestContext

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

pSgl

Ein Array von SGE-Strukturen (NDK_SGE), die die Puffer darstellen, die die zu schreibenden Daten enthalten.

[in] nSge

Die Anzahl der SGE-Strukturen im Array, das im pSgl Parameter angegeben ist.

[in] RemoteAddress

Die Remoteadresse, in die geschrieben werden soll, die in der Bytereihenfolge des lokalen Hosts angegeben wird. Der NDK-Consumer hat möglicherweise einen Offset zum remote bereitgestellten Wert hinzugefügt.

[in] RemoteToken

Das remote bereitgestellte Speichertoken, ein undurchsichtiges Bytearray vom NDK-Consumer.

[in] Flags

Ein bitweises ODER von Flags, die die zulässigen Vorgänge angibt. Die folgenden Flags werden unterstützt:

Wert	Bedeutung
NDK_OP_FLAG_SILENT_SUCCESS 0x00000001	Gibt den erfolgreichen Abschluss dieser Anforderung an, generiert aber kein Abschlussereignis in der Ausgehenden Abschlusswarteschlange. Anforderungen, die fehlschlagen, generieren jedoch einen Abschluss in der Abschlusswarteschlange.
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 die Anforderung an die Hardware zur Verarbeitung zurückstellen kann. Weitere Informationen zu diesem Flag finden Sie unter NDKPI Deferred Processing Scheme. Hinweis Dieses Flag wird nur in NDKPI 1.2 (Windows Server 2012 R2) und höher unterstützt.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Anforderung wurde erfolgreich gepostet. Ein Vervollständigungseintrag wird an die Abschlusswarteschlange (CQ) in die Warteschlange eingereiht, wenn die Arbeitsanforderung abgeschlossen ist.
STATUS_CONNECTION_INVALID	Das Warteschlangenpaar (QP) ist nicht verbunden.
Andere Statuscodes	Fehler.

Bemerkungen

NdkWrite eine Schreibanforderung für ein Warteschlangenpaar (Queue Pair, QP) veröffentlicht.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Keine unterstützt,in NDIS 6.30 und höher unterstützt.
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Fenster
Header-	ndkpi.h (include Ndkpi.h)
IRQL-	<=DISPATCH_LEVEL

Siehe auch

NDKPI Verzögertes Verarbeitungsschema

NDKPI Arbeitsanforderungsbuchungsanforderungen

NDK_QP

NDK_RESULT

NDK_SGE

Freigeben über