NDK_FN_CREATE_MR función de devolución de llamada (ndkpi.h)

  • Artículo

La función NdkCreateMr (NDK_FN_CREATE_MR) crea un objeto de región de memoria NDK (MR).

Sintaxis

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

Parámetros

[in] pNdkPd

Puntero a un objeto de dominio de protección NDK (PD) (NDK_PD).

[in] FastRegister

Si es TRUE, MR es solo para el registro rápido. De lo contrario, MR es solo para el registro normal.

[in] CreateCompletion

Puntero a una función NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) que completa la creación de un objeto NDK.

[in, optional] RequestContext

Valor de contexto que el proveedor NDK pasa de nuevo a la función NdkCreateCompletion especificada en el parámetro CreateCompletion .

ppNdkMr

Se devuelve un puntero al objeto mr creado (NDK_MR) en esta ubicación si la solicitud se realiza correctamente sin devolver STATUS_PENDING. Si NdkCreateMr devuelve STATUS_PENDING, este parámetro se omite y el objeto creado se devuelve con la devolución de llamada especificada en el parámetro CreateCompletion .

Valor devuelto

La función NdkCreateMr devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto Descripción
STATUS_SUCCESS
 El objeto MR se creó correctamente y se devolvió con el parámetro *ppNdkMr .
STATUS_PENDING
 La operación está pendiente y se completará más adelante. El proveedor llamará a la función especificada en el parámetro CreateCompletion (NDK_FN_CREATE_COMPLETION) para completar la operación pendiente.
STATUS_INSUFFICIENT_RESOURCES
 Error en la solicitud debido a recursos insuficientes.
Importante La solicitud puede producir un error en línea, así como de forma asincrónica con este código de estado.
 
Otros códigos de estado
 Se produjo un error.

Comentarios

La función NdkCreateMr crea un objeto de región de memoria NDK (MR) que se puede usar para el registro de memoria y las solicitudes de registro rápido. Si la función devuelve STATUS_SUCCESS, el objeto creado se devuelve en el parámetro ppNdkMr . Si NdkCreateMr devuelve STATUS_PENDING, la función NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) que se especifica en el parámetro CreateCompletion devuelve el objeto creado.

Requisitos

Requisito Value
Cliente mínimo compatible Ninguno compatible, compatible con NDIS 6.30 y versiones posteriores.
Servidor mínimo compatible Windows Server 2012
Plataforma de destino Windows
Encabezado ndkpi.h (incluya Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Consulte también

Requisitos de duración del objeto NDKPI

NDK_FN_CREATE_COMPLETION

NDK_MR

NDK_PD