NDK_FN_INITIALIZE_FAST_REGISTER_MR Rückruffunktion (ndkpi.h)
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 |
---|---|
|
Die Initialisierung wurde erfolgreich abgeschlossen. |
|
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. |
|
Die Anforderung ist fehlgeschlagen, weil der Adapter die angeforderte AdapterPageCount-Klasse nicht unterstützt. |
|
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 |