MiniportReconfigure

MiniportReconfigure is a function that the NDIS library currently never calls but that a MiniportInitialize function can call as an internal driver function.

NDIS_STATUS 
MiniportReconfigure(
OUT PNDIS_STATUS OpenErrorStatus,
IN NDIS_HANDLE MiniportAdapterContext,
IN NDIS_HANDLE WrapperConfigurationContext ); 

Parameters

  • OpenErrorStatus
    Points to a variable that MiniportReconfigure sets to an NDIS_STATUS_XXX code specifying additional information about the error if MiniportReconfigure will return NDIS_STATUS_OPEN_ERROR.
  • MiniportAdapterContext
    Specifies the handle to a miniport-allocated context area in which the driver maintains per-network adapter state, set up by MiniportInitialize with NdisMSetAttributes or NdisMSetAttributesEx.
  • WrapperConfigurationContext
    Specifies a handle used only during initialization for calls to NdisXXX configuration and initialization functions. For example, this handle is a required parameter to NdisOpenConfiguration and the NdisImmediateReadXXX and NdisImmediateWriteXXX functions.

Return Values

MiniportReconfigure either returns NDIS_STATUS_SUCCESS or it can return any driver-determined value, such as one of the following:

NDIS_STATUS_NOT_ACCEPTED
NDIS_STATUS_OPEN_ERROR
NDIS_STATUS_FAILURE

Comments

As an internal driver function, MiniportReconfigure might be called from MiniportInitialize to reconfigure a network adapter to new parameters returned by one of the NdisXXX bus-relative configuration functions. For example, a MiniportReconfigure function might be used to support plug-and-play network adapters or software-configurable network adapters.

Because an internal MiniportReconfigure function is called from MiniportInitialize, no other driver request can be outstanding when MiniportReconfigure is called, and NDIS will never submit another request to the miniport until its caller, MiniportInitialize, returns control.

As an internal driver function called from MiniportInitialize, MiniportReconfigure can be pageable code.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Ndis.h   Ndislib.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

MiniportInitialize, NdisMRegisterInterrupt, NdisMSetAttributes, NdisMSetAttributesEx, NdisOpenConfiguration

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.