NDK_FN_INITIALIZE_FAST_REGISTER_MR routine

The NdkInitializeFastRegisterMr (NDK_FN_INITIALIZE_FAST_REGISTER_MR) function initializes an NDK memory region (MR) for fast registration.

Syntax


NDK_FN_INITIALIZE_FAST_REGISTER_MR NdkInitializeFastRegisterMr;

NTSTATUS NdkInitializeFastRegisterMr(
  _In_      NDK_MR *pNdkMr,
  _In_      ULONG AdapterPageCount,
  _In_      BOOLEAN RemoteAccess,
  _In_      NDK_FN_REQUEST_COMPLETION RequestCompletion,
  _In_opt_  PVOID RequestContext
)
{ ... }

Parameters

pNdkMr [in]

A pointer to an NDK memory region (MR) object (NDK_MR).

AdapterPageCount [in]

The maximum number of adapter pages to support in this MR such that fast-register work requests with equal or a lower number of adapter pages can be supported.

RemoteAccess [in]

A BOOLEAN value that indicates if the MR must be initialized for remote access or not. An NDK consumer must set RemoteAccess to TRUE if the consumer will request remote access with the NdkFastRegister (NDK_FN_FAST_REGISTER) function.

RequestCompletion [in]

A pointer to a request completion callback routine NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

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 NdkInitializeFastRegisterMr function returns one of the following NTSTATUS codes.

Return codeDescription
STATUS_SUCCESS

Initialization was completed 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_IMPLEMENTATION_LIMIT

The request failed because the adapter does not support the requested AdapterPageCount.

Other status codes

An error occurred.

 

Remarks

NdkInitializeFastRegisterMr initializes an MR for fast registration. The NDK_MR object must be created with FastRegister parameter of the NdkCreateMr (NDK_FN_CREATE_MR) function set to TRUE.

You can make multiple calls to NdkInitializeFastRegisterMr, either in parallel or one after another.

After NdkInitializeFastRegisterMr returns, a fast register work request can be posted to a queue pair (QP).

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_CREATE_MR
NDK_FN_FAST_REGISTER
NDK_FN_REQUEST_COMPLETION
NDK_MR
NDKPI Object Lifetime Requirements

 

 

Send comments about this topic to Microsoft

Mostrar:
© 2015 Microsoft