Compartir a través de

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

  • Artículo

La función NdkModifySrq (NDK_FN_MODIFY_SRQ) modifica el tamaño y el umbral de notificación de una cola de recepción compartida (SRQ) de NDK.

Sintaxis

NDK_FN_MODIFY_SRQ NdkFnModifySrq;

NTSTATUS NdkFnModifySrq(
  [in]           NDK_SRQ *pNdkSrq,
  [in]           ULONG SrqDepth,
  [in]           ULONG NotifyThreshold,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parámetros

[in] pNdkSrq

Puntero a un objeto de cola de recepción compartida (SRQ) de NDK (NDK_SRQ).

[in] SrqDepth

Nuevo tamaño del SRQ. El nuevo tamaño debe ser menor o igual que el tamaño especificado en el miembro MaxSrqDepth de la estructura NDK_ADAPTER_INFO . Un tamaño de cero significa que no se solicita ninguna modificación de profundidad. Es decir, se debe conservar el valor de profundidad de SRQ existente.

[in] NotifyThreshold

Número de solicitudes de recepción en cola que desencadenarán una devolución de llamada de notificación SRQ. Si este valor es mayor que cero, el proveedor de NDK debe armar la notificación SRQ para que se desencadene cuando el número de solicitudes de recepción en cola se encuentre por debajo del valor especificado. Si el número de solicitudes de recepción en cola ya está por debajo del valor de umbral en el momento de esta llamada de función, se debe generar una notificación SRQ. Una vez generada una notificación srQ, se desargen más notificaciones hasta que el consumidor de NDK vuelva a invocar esta función con un valor de umbral distinto de cero. Si se especifica un valor de umbral de cero, el proveedor debe conservar el umbral de notificación srQ actual y el estado de arming.

[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

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

Código devuelto Descripción
STATUS_SUCCESS
 La solicitud 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_INVALID_PARAMETER
 Error en la solicitud porque el valor del parámetro SrqDepth no está dentro de los límites especificados en la estructura de NDK_ADAPTER_INFO .
Otros códigos de estado
 Se produjo un error.

Comentarios

NdkModifySrq modifica el tamaño y el umbral de notificación de un objeto de cola de recepción compartida (SRQ) de NDK (NDK_SRQ).

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_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ