Compartir a través de

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

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 del 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 del adaptador.

[in] RemoteAccess

Valor BOOLEAN que indica si se debe inicializar 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 de la función de devolución de llamada especificada en el parámetro RequestCompletion de.

Valor devuelto

El
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 especificada (NDK_FN_REQUEST_COMPLETION) para completar la operación pendiente.
STATUS_IMPLEMENTATION_LIMIT
 Error en la solicitud porque el adaptador no admite el AdapterPageCount solicitado.
otros códigos de estado
 Error.

Observaciones

NdkInitializeFastRegisterMr inicializa una mr para el registro rápido. El objeto NDK_MR debe crearse con 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 uno después de otro.

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

Requisitos

Requisito Valor
cliente mínimo admitido Ninguna compatible, compatible con NDIS 6.30 y versiones posteriores.
servidor mínimo admitido Windows Server 2012
de la plataforma de destino de Windows
encabezado de ndkpi.h (incluya Ndkpi.h)
irQL <=DISPATCH_LEVEL

Consulte también

requisitos de duración de objetos NDKPI

NDK_FN_CREATE_MR

NDK_FN_FAST_REGISTER

NDK_FN_REQUEST_COMPLETION

NDK_MR