NDK_FN_FAST_REGISTER Rückruffunktion (ndkpi.h)

Artikel
08/07/2023

Die Funktion NdkFastRegister (NDK_FN_FAST_REGISTER) registriert schnell ein Array logischer Adapterseiten über einen vorhandenen Speicherbereich.

Syntax

NDK_FN_FAST_REGISTER NdkFnFastRegister;

NTSTATUS NdkFnFastRegister(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
  [in]           NDK_MR *pMr,
  [in]           ULONG AdapterPageCount,
                 const NDK_LOGICAL_ADDRESS *AdapterPageArray,
  [in]           ULONG FBO,
  [in]           SIZE_T Length,
  [in]           PVOID BaseVirtualAddress,
  [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] pMr

Ein Zeiger auf ein NDK-Speicherregionsobjekt (MR) (NDK_MR), das für die schnelle Registrierung initialisiert wurde.

[in] AdapterPageCount

Die Anzahl der Seiten im AdapterPageArray-Parameter . Die Größe jeder Seite im AdapterPageArray beträgt PAGE_SIZE Bytes.

AdapterPageArray

Ein Array logischer Adapteradressen (NDK_LOGICAL_ADDRESS), wobei jede Adresse die logische Startadresse für eine Seite ist. Jede Adresse muss ausgerichtete Seiten sein, die PAGE_SIZE Bytes lang sind. Aufeinanderfolgende Adressen im Array sind im Hinblick auf den logischen Adressraum nicht unbedingt aufeinanderfolgende, aber das Array als Ganzes stellt aus Sicht des Hostsystems einen praktisch zusammenhängenden Speicherbereich dar.

[in] FBO

Der erste Byteoffset (FBO) auf der ersten Seite. Die registrierte Region beginnt bei diesem Offset.

[in] Length

Die Länge der Region, die ab dem FBO registriert wird, in Bytes. Die Länge muss kleiner oder gleich der Gesamtanzahl von Bytes sein, die durch den ersten Satz (AdapterPageCount) von Seiten dargestellt werden, die im AdapterPageArray-Array abzüglich des FBO enthalten sind.

[in] BaseVirtualAddress

Der vom Consumer angegebene Wert der virtuellen Adresse, der auf den ersten Bytespeicherort des Speicherbereichs verweist. Dieser Wert muss ein Vielfaches von PAGE_SIZE plus FBO sein. Die zulässigen Werte umfassen also FBO oder FBO plus n mal die PAGE_SIZE , wobei n größer oder gleich 0 ist. Null ist nur gültig, wenn FBO 0 ist.

[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_ALLOW_REMOTE_READ 0x00000008	Aktivieren Sie den Lesezugriff auf den Speicherbereich für jeden verbundenen Peer. Für den Zugriff auf die Speicherregion müssen die verbundenen Peers über ein gültiges Token verfügen.
NDK_OP_FLAG_ALLOW_LOCAL_WRITE 0x00000010	Erlauben Sie lokalen Schreibzugriff auf die Speicherregion.
NDK_OP_FLAG_ALLOW_REMOTE_WRITE 0x00000030	Aktivieren Sie den Schreibzugriff auf die Speicherregion für jeden verbundenen Peer. Für den Zugriff auf die Speicherregion müssen die verbundenen Peers über ein gültiges Token verfügen.
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

Die NDK_FN_FAST_REGISTER-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.
STATUS_ACCESS_VIOLATION	Der Speicherbereich wurde während der Schnellregistrierungsinitialisierung nicht für den Remotezugriff initialisiert, sondern die Arbeitsanforderung für schnelle Registrierung NDK_OP_FLAG_ALLOW_REMOTE_READ oder NDK_OP_FLAG_ALLOW_REMOTE_WRITE angegeben.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

NdkFastRegister registriert schnell ein Array logischer Adapterseiten über einer vorhandenen Speicherregion, die für die schnelle Registrierung initialisiert wird.

Nachdem dieser Aufruf zurückgegeben wurde, ist das Speicherregionstoken für den Remotezugriff mit der Funktion NdkGetRemoteTokenFromMr (NDK_FN_GET_REMOTE_TOKEN_FROM_MR) des MR verfügbar.

NdkFastRegister unterstützt keine nullbasierten virtuellen Adressen.

Wenn das NDK_ADAPTER_FLAG_RDMA_READ_SINK_NOT_REQUIRED-Flag im AdapterFlags-Member der NDK_ADAPTER_INFO-Struktur nicht festgelegt ist, muss ein NDK-Consumer das NDK_OP_FLAG_RDMA_READ_SINK-Flag übergeben, wenn er Arbeitsspeicher registriert, der als Senkenpuffer für eine RDMA-Leseanforderung verwendet werden kann. Bestimmte NDK-Anbieter erfordern möglicherweise die Aktivierung spezieller Zugriffsrechte für den Senkenpuffer für eine RDMA-Leseanforderung. Dieses Flag ermöglicht es diesen Anbietern, Registrierungsanforderungen entsprechend zu unterstützen. Beachten Sie, dass Puffer für mehrere Zwecke registriert werden können, daher kann dieses Flag von anderen begleitet werden.

Wenn ein NDK-Consumer das NDK_OP_FLAG_RDMA_READ_SINK-Flag für einen Adapter übergibt, für den das NDK_ADAPTER_FLAG_RDMA_READ_SINK_NOT_REQUIRED-Flag im AdapterFlags-Member der NDK_ADAPTER_INFO-Struktur festgelegt ist, muss der Anbieter das NDK_OP_FLAG_RDMA_READ_SINK-Flag nicht verarbeiten und darf die Anforderung aufgrund des Vorhandenseins dieses Flags nicht fehlschlagen.

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