NDK_FN_CREATE_MR Rückruffunktion (ndkpi.h)

  • Artikel

Die Funktion NdkCreateMr (NDK_FN_CREATE_MR) erstellt ein NDK-Objekt (NDK Memory Region, MR).

Syntax

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
)
{...}

Parameter

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

Rückgabewert

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

Rückgabecode Beschreibung
STATUS_SUCCESS
 Das MR-Objekt wurde erfolgreich erstellt und mit dem Parameter *ppNdkMr 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 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.

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_MR

NDK_PD