NDK_FN_CREATE_MW Rückruffunktion (ndkpi.h)
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 |
|---|---|
|
Das MW-Objekt wurde erfolgreich erstellt und mit dem Parameter *ppNdkMw zurückgegeben. |
|
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. |
|
Fehler bei der Anforderung aufgrund unzureichender Ressourcen.
Wichtig Die Anforderung kann sowohl inline als auch asynchron mit diesem status Code fehlschlagen.
|
|
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 |