NDK_FN_CREATE_MR Rückruffunktion (ndkpi.h)
Die Funktion NdkCreateMr (NDK_FN_CREATE_MR) erstellt ein NDK-Objekt (NDK Memory Region, MR).
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
)
{...}
[in] pNdkPd
Ein Zeiger auf ein PD-Objekt (NDK Protection Domain) (NDK_PD).
[in] FastRegister
Bei TRUE ist MR nur für die schnelle Registrierung vorgesehen. Andernfalls gilt MR nur für das normale Register.
[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.
ppNdkMr
Ein Zeiger auf das erstellte MR-Objekt (NDK_MR) wird an diesem Speicherort zurückgegeben, wenn die Anforderung erfolgreich ist, ohne STATUS_PENDING zurückzugeben. Wenn NdkCreateMrSTATUS_PENDING zurückgibt, wird dieser Parameter ignoriert, und das erstellte Objekt wird mit dem Rückruf zurückgegeben, der im CreateCompletion-Parameter angegeben ist.
Die NdkCreateMr-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.
Rückgabecode | Beschreibung |
---|---|
|
Das MR-Objekt wurde erfolgreich erstellt und mit dem Parameter *ppNdkMr 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. |
Die NdkCreateMr-Funktion erstellt ein NDK-Speicherregion -Objekt (MR), das für die Speicherregistrierung und schnelle Registrierungsanforderungen verwendet werden kann. Wenn die Funktion STATUS_SUCCESS zurückgibt, wird das erstellte Objekt im ppNdkMr-Parameter zurückgegeben. Wenn NdkCreateMrSTATUS_PENDING zurückgibt, wird das erstellte Objekt von der NdkCreateCompletion-Funktion (NDK_FN_CREATE_COMPLETION) zurückgegeben, die im CreateCompletion-Parameter angegeben ist.
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 |