NDK_FN_CREATE_PD Rückruffunktion (ndkpi.h)
Die Funktion NdkCreatePd (NDK_FN_CREATE_PD) erstellt ein NDK-Schutzdomänenobjekt (PD).
Syntax
NDK_FN_CREATE_PD NdkFnCreatePd;
NTSTATUS NdkFnCreatePd(
[in] NDK_ADAPTER *pNdkAdapter,
[in] NDK_FN_CREATE_COMPLETION CreateCompletion,
[in, optional] PVOID RequestContext,
NDK_PD **ppNdkPd
)
{...}
Parameter
[in] pNdkAdapter
Ein Zeiger auf ein NDK-Adapterobjekt (NDK_ADAPTER).
[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.
ppNdkPd
An diesem Speicherort wird ein Zeiger auf ein erstelltes PD-Objekt (NDK_PD) 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 NdkCreatePd-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Das PD-Objekt wurde erfolgreich erstellt und mit dem Parameter *ppNdkPd zurückgegeben. |
|
Der Vorgang ist ausstehend 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 NdkCreatePd-Funktion erstellt ein NDK-Schutzdomänenobjekt (PD). Wenn die Funktion STATUS_SUCCESS zurückgibt, wird das erstellte Objekt im ppNdkPd-Parameter zurückgegeben. Wenn NdkCreatePd STATUS_PENDING zurückgibt, wird das erstellte Objekt von der NdkCreateCompletion-Funktion (NDK_FN_CREATE_COMPLETION) zurückgegeben, die im CreateCompletion-Parameter angegeben ist.
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 |