NDK_FN_QUERY_ADAPTER_INFO callback function (ndkpi.h)

  • Article

The NdkQueryAdapterInfo (NDK_FN_QUERY_ADAPTER_INFO) function retrieves information about limits and capabilities of an NDK adapter.

Syntax

NDK_FN_QUERY_ADAPTER_INFO NdkFnQueryAdapterInfo;

NTSTATUS NdkFnQueryAdapterInfo(
  [in] NDK_ADAPTER *pNdkAdapter,
       NDK_ADAPTER_INFO *pInfo,
       ULONG *pBufferSize
)
{...}

Parameters

[in] pNdkAdapter

A pointer to an NDK adapter (NDK_ADAPTER) instance.

pInfo

A pointer to a buffer that contains an NDK_ADAPTER_INFO structure. If the request completes with STATUS_SUCCESS, the NDK provider fills the structure with adapter information.

pBufferSize

On input, this parameter is a pointer to a variable that holds the size, in bytes, of the buffer that the pInfo parameter points to. On output, the variable receives the size, in bytes, of the adapter information that was written into the buffer.

Return value

The NdkQueryAdapterInfo function returns one of the following NTSTATUS codes.

Return code Description
STATUS_SUCCESS
 The request completed successfully.
STATUS_BUFFER_TOO_SMALL

The value in the *pBufferSize parameter specified a buffer size that was too small to hold the adapter information. *pBufferSize is updated with the required size.
Other status codes
 An error occurred.

Remarks

NdkQueryAdapterInfo retrieves the adapter information in an NDK_ADAPTER_INFO structure. The structure contains information on various limits and capabilities of the adapter.

NdkQueryAdapterInfo requires an IRQL equal to PASSIVE_LEVEL and it blocks until the request is completed.

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 PASSIVE_LEVEL

See also

NDK_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_ADAPTER_INFO