NDK_FN_CREATE_MW Rückruffunktion (ndkpi.h)

Artikel
02/07/2025

Die NdkCreateMw- (NDK_FN_CREATE_MW) -Funktion erstellt ein NDK-Speicherfensterobjekt (MW).

Syntax

NDK_FN_CREATE_MW NdkFnCreateMw;

NTSTATUS NdkFnCreateMw(
  [in]           NDK_PD *pNdkPd,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_MW **ppNdkMw
)
{...}

Parameter

[in] pNdkPd

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

[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.

ppNdkMw

Ein Zeiger auf ein erstelltes MW-Objekt (NDK_MW) wird an diesem Speicherort zurückgegeben, wenn die Anforderung erfolgreich ist, ohne STATUS_PENDING zurückzugeben. Wenn die Anforderung STATUS_PENDING zurückgibt, wird dieser Parameter ignoriert, und das erstellte Objekt wird mit dem Rückruf zurückgegeben, der im parameter CreateCompletion angegeben ist.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Das MW-Objekt wurde erfolgreich erstellt und mit dem *ppNdkMw Parameter 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 NdkCreateMw--Funktion erstellt ein NDK-Speicherfensterobjekt (MW), das für Bindungsanforderungen verwendet werden kann. Wenn die Funktion STATUS_SUCCESS zurückgibt, wird das erstellte Objekt im ppNdkMw-Parameter zurückgegeben. Wenn NdkCreateMw STATUS_PENDING zurückgibt, wird das erstellte Objekt vom NdkCreateCompletion- (NDK_FN_CREATE_COMPLETION) -Funktion zurückgegeben, die im parameter CreateCompletion 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_MW

NDK_PD

Freigeben über