NDK_FN_RESIZE_CQ callback function (ndkpi.h)

The NdkResizeCq (NDK_FN_RESIZE_CQ) function changes the size of an NDK completion queue (CQ).

Syntax

NDK_FN_RESIZE_CQ NdkFnResizeCq;

NTSTATUS NdkFnResizeCq(
  [in]           NDK_CQ *pNdkCq,
  [in]           ULONG CqDepth,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameters

[in] pNdkCq

A pointer to an NDK completion queue (CQ) object (NDK_CQ).

[in] CqDepth

The new number of completion entries that the CQ can hold. The CQ size must be less than or equal to the value that is specified in the MaxCqDepth member in the NDK_ADAPTER_INFO structure.

[in] RequestCompletion

A pointer to an NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION) function.

[in, optional] RequestContext

A context value to pass to the Context parameter of the callback function that is specified in the RequestCompletion parameter.

Return value

The NDK_FN_RESIZE_CQ function returns one of the following NTSTATUS codes.

Return code Description
STATUS_SUCCESS
The CQ was resized successfully.
STATUS_PENDING
The operation is pending and will be completed later. The driver will call the specified RequestCompletion (NDK_FN_REQUEST_COMPLETION) function to complete the pending operation.
STATUS_INVALID_PARAMETER
The request failed because the CQ size that is specified in the CqDepth parameter is greater than the value in the MaxCqDepth member in the NDK_ADAPTER_INFO structure.
STATUS_INSUFFICIENT_RESOURCES
The request failed due to insufficient resources.
Important  The request can fail inline as well as asynchronously with this status code.
 
Other status codes
An error occurred.

Remarks

NdkResizeCq changes the number of completion entries that a CQ can hold.

Requirements

Requirement Value
Minimum supported client None supported,Supported in NDIS 6.30 and later.
Minimum supported server Windows Server 2012
Target Platform Windows
Header ndkpi.h (include Ndkpi.h)
IRQL <=DISPATCH_LEVEL

See also

NDKPI Object Lifetime Requirements

NDK_ADAPTER_INFO

NDK_CQ

NDK_CQ_DISPATCH

NDK_FN_REQUEST_COMPLETION