NDK_FN_MODIFY_SRQ función de devolución de llamada (ndkpi.h)
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 de SRQ. El nuevo tamaño debe ser menor o igual que el tamaño especificado en el MaxSrqDepth miembro 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 armá la notificación SRQ para que se desencadene cuando el número de solicitudes de recepción en cola esté 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. Después de generar una notificación SRQ, las notificaciones adicionales se desargen hasta que el consumidor de NDK invoca esta función de nuevo 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 brazo.
[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
La función NdkModifySrq devuelve uno de los siguientes códigos NTSTATUS.
| Código devuelto | Descripción |
|---|---|
|
La solicitud se completó correctamente. |
|
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. |
|
Error en la solicitud porque el valor del parámetro srqDepth no está dentro de los límites especificados en la estructura NDK_ADAPTER_INFO. |
|
Error. |
Observaciones
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 | 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 |