NDK_FN_CREATE_MR Rückruffunktion (ndkpi.h)

Artikel
02/07/2025

Die NdkCreateMr- (NDK_FN_CREATE_MR) -Funktion erstellt ein NDK-Speicherbereichsobjekt (MR).

Syntax

NDK_FN_CREATE_MR NdkFnCreateMr;

NTSTATUS NdkFnCreateMr(
  [in]           NDK_PD *pNdkPd,
  [in]           BOOLEAN FastRegister,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_MR **ppNdkMr
)
{...}

Parameter

[in] pNdkPd

Ein Zeiger auf ein NDK-Schutzdomänenobjekt (PD) (NDK_PD).

[in] FastRegister

Wenn WAHR, ist MR nur für schnelle Registrierung vorgesehen. Andernfalls ist MR nur für das normale Register vorgesehen.

[in] CreateCompletion

Ein Zeiger auf eine NdkCreateCompletion- (NDK_FN_CREATE_COMPLETION) -Funktion, die die Erstellung eines NDK-Objekts abschließt.

[in, optional] RequestContext

Ein Kontextwert, den der NDK-Anbieter an die NdkCreateCompletion--Funktion übergibt, die im CreateCompletion-Parameter angegeben ist.

ppNdkMr

Ein Zeiger auf das erstellte MR-Objekt (NDK_MR) wird an diesem Speicherort zurückgegeben, wenn die Anforderung erfolgreich ist, ohne STATUS_PENDINGzurückzugeben. Wenn NdkCreateMrSTATUS_PENDINGzurückgibt, wird dieser Parameter ignoriert, und das erstellte Objekt wird mit dem Rückruf zurückgegeben, der im CreateCompletion Parameter angegeben ist.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Das MR-Objekt wurde erfolgreich erstellt und mit dem parameter "ppNdkMr" ppNdkMr zurückgegeben.
STATUS_PENDING	Der Vorgang steht aus und wird später abgeschlossen. Der Anbieter ruft die im CreateCompletion Parameter(NDK_FN_CREATE_COMPLETION) angegebene Funktion auf, um den ausstehenden Vorgang abzuschließen.
STATUS_INSUFFICIENT_RESOURCES	Fehler bei der Anforderung aufgrund unzureichender Ressourcen. Wichtig Die Anforderung kann inline und asynchron mit diesem Statuscode fehlschlagen.
Andere Statuscodes	Fehler.

Bemerkungen

Die NdkCreateMr--Funktion erstellt ein NDK-Speicherbereichsobjekt (MR), das für die Speicherregistrierung und schnelle Registrierungsanforderungen verwendet werden kann. Wenn die Funktion STATUS_SUCCESSzurückgibt, wird das erstellte Objekt im ppNdkMr-Parameter zurückgegeben. Wenn NdkCreateMrSTATUS_PENDINGzurückgibt, wird das erstellte Objekt von der NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) -Funktion zurückgegeben, die im CreateCompletion Parameter angegeben ist.

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

anforderungen für NDKPI-Objektlebensdauer

NDK_FN_CREATE_COMPLETION

NDK_MR

NDK_PD

Freigeben über