NET_REQUEST_QUEUE_CONFIG_ADD_QUERY_DATA_HANDLER function

Warning

Some information in this topic relates to prereleased product, which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

NetAdapterCx is preview only in Windows 10, version 1903.

Adds a caller-provided handler for a specific OID query data request to a NET_REQUEST_QUEUE_CONFIG structure.

Syntax

void NET_REQUEST_QUEUE_CONFIG_ADD_QUERY_DATA_HANDLER(
  NET_REQUEST_QUEUE_CONFIG   *NetRequestQueueConfig,
  NDIS_OID                   Oid,
  PFN_NET_REQUEST_QUERY_DATA EvtRequestQueryData,
  UINT                       MinimumOutputLength
);

Parameters

NetRequestQueueConfig

A pointer to a driver-allocated NET_REQUEST_QUEUE_CONFIG structure to which the custom handler is being added.

Oid

The object identifier of the requested operation. The value is an OID_XXX code.

EvtRequestQueryData

A pointer to the client driver's implementation of a EVT_NET_REQUEST_QUERY_DATA event callback function.

MinimumOutputLength

A UINT specifying the minimum output length for the request.

Return Value

This method does not return a value.

Remarks

When the client driver has finished adding custom handlers, it registers them with NetAdapterCx by calling NetRequestQueueCreate.

If the memory allocation for this method fails, the subsequent call to NetRequestQueueCreate returns a failure code.

This function has the same effect as the following call sequence:

  1. NET_REQUEST_QUEUE_QUERY_DATA_HANDLER_INIT
  2. NET_REQUEST_QUEUE_CONFIG_ADD_INITIALIZED_QUERY_DATA_HANDLER

Requirements

   
Target Platform Universal
Minimum KMDF version 1.21
Header netrequestqueue.h
IRQL PASSIVE_LEVEL