NDK_FN_RESIZE_CQ callback function (ndkpi.h)

Article
02/22/2024

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