NDK_FN_CREATE_MW Rückruffunktion (ndkpi.h)

Artikel
02/29/2024

Die Funktion NdkCreateMw (NDK_FN_CREATE_MW) 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 PD-Objekt (NDK Protection Domain) (NDK_PD).

[in] CreateCompletion

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

[in, optional] RequestContext

Ein Kontextwert, den der NDK-Anbieter an die NdkCreateCompletion-Funktion zurückgibt, 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 CreateCompletion-Parameter 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 Parameter ppNdkMw* 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 sowohl inline als auch asynchron mit diesem status Code fehlschlagen.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

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 von der funktion NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) zurückgegeben, die im CreateCompletion-Parameter angegeben ist.

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

Weitere Informationen

Anforderungen an die Lebensdauer des NDKPI-Objekts

NDK_FN_CREATE_COMPLETION

NDK_MW

NDK_PD

Freigeben über