NDK_FN_INVALIDATE callback function

The NdkInvalidate (NDK_FN_INVALIDATE) function Invalidates a fast-register NDK memory region (MR) or memory window (MW).

Syntax


NDK_FN_INVALIDATE NdkInvalidate;

NTSTATUS NdkInvalidate(
  _In_     NDK_QP            *pNdkQp,
  _In_opt_ PVOID             RequestContext,
  _In_     NDK_OBJECT_HEADER *pNdkMrOrMw,
  _In_     ULONG             Flags
)
{ ... }

Parameters

pNdkQp [in]

A pointer to an NDK queue pair (QP) object (NDK_QP).

RequestContext [in, optional]

A context value to return in the RequestContext member of the NDK_RESULT structure for this request.

pNdkMrOrMw [in]

A pointer to either an memory region (MR) object (NDK_MR) or an memory (MW) object (NDK_MW) that is specified in an NDK_OBJECT_HEADER structure. If an MR object is specified, the MR object must have been registered with the NdkFastRegister (NDK_FN_FAST_REGISTER) function. The NDK consumer must never specify an MR object that was registered with the NdkRegister (NDK_FN_REGISTER) function in the pNdkMrOrMw parameter. Access to MR objects registered with the NdkRegister (NDK_FN_REGISTER)) function can be removed with the NdkDeregisterMr (NDK_FN_DEREGISTER_MR) function.

Flags [in]

A bitwise OR of flags which specifies the operations that are allowed. The following flags are supported:

ValueMeaning
NDK_OP_FLAG_SILENT_SUCCESS
0x00000001

Indicates the successful completion of this request does not generate a completion event in the outbound completion queue. However, requests that fail do generate an event in the completion queue.

NDK_OP_FLAG_READ_FENCE
0x00000002

Indicates that all prior read requests must be complete before the hardware begins processing this request.

NDK_OP_FLAG_DEFER
0x00000200

Indicates to the NDK provider that it may defer indicating the request to hardware for processing. For more information about this flag, see NDKPI Deferred Processing Scheme.

Note  This flag is supported only in NDKPI 1.2 (Windows Server 2012 R2) and later.

 

Return value

The NdkInvalidate function returns one of the following NTSTATUS codes.

Return codeDescription
STATUS_SUCCESS

The request was posted successfully. A completion entry will be queued to the CQ when the work request is completed.

STATUS_CONNECTION_INVALID

The QP is not connected.

Other status codes

An error occurred.

 

Remarks

NdkInvalidate invalidates an NDK fast-register MR or MW.

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_FN_FAST_REGISTER
NDK_FN_DEREGISTER_MR
NDK_FN_REGISTER
NDK_MR
NDK_MW
NDK_OBJECT_HEADER
NDK_QP
NDK_RESULT
NDKPI Completion Handling Requirements
NDKPI Deferred Processing Scheme
NDKPI Work Request Posting Requirements

 

 

Send comments about this topic to Microsoft

Show: