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

Artículo
02/07/2025

La función NdkWrite (NDK_FN_WRITE) publica una solicitud de escritura en un par de colas NDK (QP).

Sintaxis

NDK_FN_WRITE NdkFnWrite;

NTSTATUS NdkFnWrite(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
                 const NDK_SGE *pSgl,
  [in]           ULONG nSge,
  [in]           UINT64 RemoteAddress,
  [in]           UINT32 RemoteToken,
  [in]           ULONG Flags
)
{...}

Parámetros

[in] pNdkQp

Puntero a un objeto de par de cola NDK (QP) (NDK_QP).

[in, optional] RequestContext

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

pSgl

Matriz de estructuras SGE (NDK_SGE) que representan los búferes que contienen los datos que se van a escribir.

[in] nSge

Número de estructuras SGE de la matriz especificada en el parámetro pSgl.

[in] RemoteAddress

Dirección remota en la que se va a escribir, proporcionada en el orden de bytes del host local. Es posible que el consumidor de NDK haya agregado un desplazamiento al valor proporcionado de forma remota.

[in] RemoteToken

El token de memoria proporcionado de forma remota, una matriz opaca de bytes del consumidor de NDK.

[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 la finalización correcta de esta solicitud, pero no genera un evento de finalización en la cola de finalización de salida. Sin embargo, las solicitudes que producen un error generan una finalización 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 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

La función NdkWrite 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 la cola de finalización (CQ) cuando se complete la solicitud de trabajo.
STATUS_CONNECTION_INVALID	El par de colas (QP) no está conectado.
otros códigos de estado	Error.

Observaciones

NdkWrite publica una solicitud de escritura 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

esquema de procesamiento diferido de NDKPI

requisitos de registro de solicitudes de trabajo de NDKPI

NDK_QP

NDK_RESULT

NDK_SGE

Compartir a través de