NdisMSetInformationComplete

VOID
NdisMSetInformationComplete(
IN NDIS_HANDLE MiniportAdapterHandle,
IN NDIS_STATUS Status
);

NdisMSetInformationComplete returns the final status of a completed set-information request for which the driver previously returned NDIS_STATUS_PENDING.

Parameters

MiniportAdapterHandle: Specifies the handle originally input to MiniportInitialize.
Status: Specifies the final status of the immediately preceding request input to MiniportSetInformation.

Comments

A miniport calls NdisMSetInformationComplete after it has carried out the operation orginally requested of its MiniportSetInformation function. This call releases the miniport’s ownership of all buffer addresses that were passed to MiniportSetInformation.

NdisMSetInformationComplete causes NDIS to return the original request to the ProtocolRequestComplete function of the driver, if any, that initiated the set-information operation when it called NdisRequest. The NDIS library also can call MiniportSetInformation directly with NDIS-initiated set-information requests, particularly during initialization just after MiniportQueryInformation returns control.

All calls to a driver’s MiniportSetInformation function are both synchronous and serialized. That is, NDIS never submits another such request until the miniport has completed the preceding request.

For more information about the system-defined OIDs that the MiniportSetInformation function handles, see Chapter 5.

Callers of NdisMSetInformationComplete run at IRQL DISPATCH_LEVEL.