NDK_FN_QUERY_ADAPTER_INFO callback function (ndkpi.h)

Article
02/22/2024

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