NDK_FN_INITIALIZE_FAST_REGISTER_MR Rückruffunktion (ndkpi.h)

  • Artikel

Die Funktion NdkInitializeFastRegisterMr (NDK_FN_INITIALIZE_FAST_REGISTER_MR) initialisiert einen NDK-Speicherbereich (MR) für eine schnelle Registrierung.

Syntax

NDK_FN_INITIALIZE_FAST_REGISTER_MR NdkFnInitializeFastRegisterMr;

NTSTATUS NdkFnInitializeFastRegisterMr(
  [in]           NDK_MR *pNdkMr,
  [in]           ULONG AdapterPageCount,
  [in]           BOOLEAN RemoteAccess,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkMr

Ein Zeiger auf ein MR-Objekt (NDK Memory Region) (NDK_MR).

[in] AdapterPageCount

Die maximale Anzahl von Adapterseiten, die in diesem MR unterstützt werden sollen, sodass Arbeitsanforderungen mit schneller Registrierung mit der gleichen oder einer niedrigeren Anzahl von Adapterseiten unterstützt werden können.

[in] RemoteAccess

Ein BOOLEscher Wert, der angibt, ob der MR für den Remotezugriff initialisiert werden muss oder nicht. Ein NDK-Consumer muss RemoteAccess auf TRUE festlegen, wenn der Consumer Remotezugriff mit der Funktion NdkFastRegister (NDK_FN_FAST_REGISTER) anfordern wird.

[in] RequestCompletion

Ein Zeiger auf die Rückrufroutine NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION) der Anforderungsvervollständigung.

[in, optional] RequestContext

Ein Kontextwert, der an den Context-Parameter der Rückruffunktion übergeben werden soll, der im RequestCompletion-Parameter angegeben ist.

Rückgabewert

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

Rückgabecode Beschreibung
STATUS_SUCCESS
 Die Initialisierung wurde erfolgreich abgeschlossen.
STATUS_PENDING
 Der Vorgang ist ausstehend und wird später abgeschlossen. Der Treiber ruft die angegebene RequestCompletion-Funktion (NDK_FN_REQUEST_COMPLETION) auf, um den ausstehenden Vorgang abzuschließen.
STATUS_IMPLEMENTATION_LIMIT
 Die Anforderung ist fehlgeschlagen, weil der Adapter die angeforderte AdapterPageCount-Klasse nicht unterstützt.
Andere status Codes
 Ein Fehler ist aufgetreten.

Hinweise

NdkInitializeFastRegisterMr initialisiert einen MR für eine schnelle Registrierung. Das NDK_MR-Objekt muss erstellt werden, wobei der FastRegister-Parameter der funktion NdkCreateMr (NDK_FN_CREATE_MR) auf TRUE festgelegt ist.

Sie können mehrere Aufrufe an NdkInitializeFastRegisterMr ausführen, entweder parallel oder nacheinander.

Nachdem NdkInitializeFastRegisterMr zurückgegeben wurde, kann eine Arbeitsanforderung für schnelle Registrierung an ein Warteschlangenpaar (QP) gesendet werden.

Anforderungen

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

Weitere Informationen

Anforderungen an die Lebensdauer des NDKPI-Objekts

NDK_FN_CREATE_MR

NDK_FN_FAST_REGISTER

NDK_FN_REQUEST_COMPLETION

NDK_MR