NetRequestSetBytesNeeded 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.

Sets the number of bytes needed to read or write for a control request (OID).

Syntax

void NetRequestSetBytesNeeded(
  NETREQUEST Request,
  UINT       BytesNeeded
);

Parameters

Request

A handle to a network request object.

BytesNeeded

The number of bytes to be read or written.

Return Value

This method does not return a value.

Remarks

The client calls this routine if the I/O request fails due a smaller than expected InputOutputBuffer size. For example, to report that 8 bytes are required to support the requested OID:

status = STATUS_BUFFER_TOO_SMALL;
NetRequestSetBytesNeeded(Request, sizeof(ULONG64));

Depending on the request type, BytesNeeded may mean space required perform a read operation or a write operation.

After calling NetRequestSetBytesNeeded, the client calls one of the following methods, or NetRequestCompleteWithoutInformation:

For general info about control requests, see Handling Control Requests.

Requirements

   
Target Platform Universal
Minimum KMDF version 1.21
Header netrequest.h (include netadaptercx.h)
IRQL <= DISPATCH_LEVEL