NDK_FN_RESIZE_CQ routine

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

Syntax


NDK_FN_RESIZE_CQ NdkResizeCq;

NTSTATUS NdkResizeCq(
  _In_      NDK_CQ *pNdkCq,
  _In_      ULONG CqDepth,
  _In_      NDK_FN_REQUEST_COMPLETION RequestCompletion,
  _In_opt_  PVOID RequestContext
)
{ ... }

Parameters

pNdkCq [in]

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

CqDepth [in]

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

RequestCompletion [in]

A pointer to an NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION) function.

RequestContext [in, optional]

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 codeDescription
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

Minimum supported client

None supported

Minimum supported server

Windows Server 2012

Version

Supported in NDIS 6.30 and later.

Header

Ndkpi.h (include Ndkpi.h)

IRQL

<=DISPATCH_LEVEL

See also

NDK_ADAPTER_INFO
NDK_CQ
NDK_CQ_DISPATCH
NDK_FN_REQUEST_COMPLETION
NDKPI Object Lifetime Requirements

 

 

Send comments about this topic to Microsoft

Mostrar:
© 2014 Microsoft