NDK_FN_READ Rückruffunktion (ndkpi.h)

Artikel
02/07/2025

Die NdkRead- (NDK_FN_READ) stellt eine Leseanforderung für ein NDK-Warteschlangenpaar (QP) dar.

Syntax

NDK_FN_READ NdkFnRead;

NTSTATUS NdkFnRead(
  [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, in die eingehende Daten eingefügt werden sollen.

[in] nSge

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

[in] RemoteAddress

Eine Remoteadresse, aus der gelesen werden soll, die in der Bytereihenfolge des lokalen Hosts angezeigt wird. Der NDK-Consumer kann dem remote bereitgestellten Wert einen Offset hinzufügen.

[in] RemoteToken

Ein remote bereitgestelltes Speichertoken, das ein undurchsichtiges Bytearray vom NDK-Consumer ist.

[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 an, dass der erfolgreiche Abschluss dieser Anforderung kein Abschlussereignis in der Ausgehenden Vervollständigungswarteschlange generiert. Anforderungen, die fehlschlagen, generieren jedoch ein Ereignis 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_RDMA_READ_LOCAL_INVALIDATE 0x00000200	Wenn dieses Kennzeichen festgelegt ist und der Anbieter auch NDK_ADAPTER_FLAG_RDMA_READ_LOCAL_INVALIDATE_SUPPORTED Adapterfunktion in der NDK_ADAPTER_INFO Struktur meldet, bedeutet der erfolgreiche Abschluss der NdkRead--Funktion, dass der erste im pSgl- Parameter angegebene Puffer ungültig ist. Der erfolglose Abschluss verlässt den Puffer und das Token in einem nicht definierten Zustand. Dieses Kennzeichen wird ignoriert, wenn der Anbieter nicht NDK_ADAPTER_FLAG_RDMA_READ_LOCAL_INVALIDATE_SUPPORTED Adapterfunktion in der NDK_ADAPTER_INFO Struktur meldet. Hinweis Dieses Flag wird nur in NDKPI 1.2 (Windows Server 2012 R2) und höher unterstützt.
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 funktion NdkRead gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Anforderung wurde erfolgreich gepostet. Wenn die Arbeitsanforderung abgeschlossen ist, wird ein Vervollständigungseintrag in die CQ-Warteschlange eingereiht.
STATUS_CONNECTION_INVALID	Der QP ist nicht verbunden.
STATUS_REMOTE_RESOURCES	Die Anforderung hat versucht, über die Größe des Remotespeichers hinaus zu lesen.
Andere Statuscodes	Fehler.

Bemerkungen

NdkRead- eine Leseanforderung für ein Warteschlangenpaar (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