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

Artículo
02/29/2024

La función NdkInvalidate (NDK_FN_INVALIDATE) invalida una región de memoria NDK de registro rápido (MR) o una ventana de memoria (MW).

Sintaxis

NDK_FN_INVALIDATE NdkFnInvalidate;

NTSTATUS NdkFnInvalidate(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
  [in]           NDK_OBJECT_HEADER *pNdkMrOrMw,
  [in]           ULONG Flags
)
{...}

Parámetros

[in] pNdkQp

Puntero a un par de colas NDK (QP) (NDK_QP).

[in, optional] RequestContext

Valor de contexto que se va a devolver en el miembro RequestContext de la estructura NDK_RESULT para esta solicitud.

[in] pNdkMrOrMw

Puntero a un objeto de región de memoria (NDK_MR) o a un objeto de memoria (NDK_MW) especificado en una estructura de NDK_OBJECT_HEADER . Si se especifica un objeto MR, el objeto MR debe haberse registrado con la función NdkFastRegister (NDK_FN_FAST_REGISTER). El consumidor de NDK nunca debe especificar un objeto mr registrado con la función NdkRegister (NDK_FN_REGISTER) en el parámetro pNdkMrOrMw . El acceso a los objetos mr registrados con la función NdkRegister (NDK_FN_REGISTER)) se puede quitar con la función NdkDeregisterMr (NDK_FN_DEREGISTER_MR).

[in] Flags

Or bit a bit de marcas que especifica las operaciones permitidas. Se admiten las marcas siguientes:

Valor	Significado
NDK_OP_FLAG_SILENT_SUCCESS 0x00000001	Indica que la finalización correcta de esta solicitud no genera un evento de finalización en la cola de finalización de salida. Sin embargo, las solicitudes que producen un error generan un evento en la cola de finalización.
NDK_OP_FLAG_READ_FENCE 0x00000002	Indica que todas las solicitudes de lectura anteriores deben completarse antes de que el hardware comience a procesar esta solicitud.
NDK_OP_FLAG_DEFER 0x00000200	Indica al proveedor de NDK que puede aplazar la solicitud al hardware para su procesamiento. Para obtener más información sobre esta marca, vea Esquema de procesamiento diferido de NDKPI. Nota Esta marca solo se admite en NDKPI 1.2 (Windows Server 2012 R2) y versiones posteriores.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	La solicitud se publicó correctamente. Una entrada de finalización se pondrá en cola en el CQ cuando se complete la solicitud de trabajo.
STATUS_CONNECTION_INVALID	El QP no está conectado.
Otros códigos de estado	Se produjo un error.

Comentarios

NdkInvalidate invalida un MR o MW de registro rápido de NDK.

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