Compartir a través de

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

  • Artículo

La función NdkInitializeFastRegisterMr (NDK_FN_INITIALIZE_FAST_REGISTER_MR) inicializa una región de memoria NDK (MR) para un registro rápido.

Sintaxis

NDK_FN_INITIALIZE_FAST_REGISTER_MR NdkFnInitializeFastRegisterMr;

NTSTATUS NdkFnInitializeFastRegisterMr(
  [in]           NDK_MR *pNdkMr,
  [in]           ULONG AdapterPageCount,
  [in]           BOOLEAN RemoteAccess,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parámetros

[in] pNdkMr

Puntero a un objeto de región de memoria NDK (MR) (NDK_MR).

[in] AdapterPageCount

El número máximo de páginas de adaptador que se admitirán en este MR, de modo que se puedan admitir solicitudes de trabajo de registro rápido con un número igual o inferior de páginas de adaptador.

[in] RemoteAccess

Valor BOOLEAN que indica si se debe inicializar la mr para el acceso remoto o no. Un consumidor de NDK debe establecer RemoteAccess en TRUE si el consumidor solicitará acceso remoto con la función NdkFastRegister (NDK_FN_FAST_REGISTER).

[in] RequestCompletion

Puntero a una rutina de devolución de llamada de finalización de solicitudes NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valor de contexto que se va a pasar al parámetro Context de la función de devolución de llamada especificada en el parámetro RequestCompletion .

Valor devuelto

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

Código devuelto Descripción
STATUS_SUCCESS
 La inicialización se completó correctamente.
STATUS_PENDING
 La operación está pendiente y se completará más adelante. El controlador llamará a la función RequestCompletion (NDK_FN_REQUEST_COMPLETION) especificada para completar la operación pendiente.
STATUS_IMPLEMENTATION_LIMIT
 Error en la solicitud porque el adaptador no admite adapterPageCount solicitado.
Otros códigos de estado
 Se produjo un error.

Comentarios

NdkInitializeFastRegisterMr inicializa un MR para un registro rápido. El objeto NDK_MR debe crearse con el parámetro FastRegister de la función NdkCreateMr (NDK_FN_CREATE_MR) establecida en TRUE.

Puede realizar varias llamadas a NdkInitializeFastRegisterMr, ya sea en paralelo o una después de otra.

Después de que NdkInitializeFastRegisterMr vuelva, se puede publicar una solicitud de trabajo de registro rápido en un par de colas (QP).

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_MR

NDK_FN_FAST_REGISTER

NDK_FN_REQUEST_COMPLETION

NDK_MR