MiniportReconfigure

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

MiniportReconfigureis a function that the NDIS library currently never calls but that a MiniportInitializefunction 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 MiniportReconfiguresets to an NDIS_STATUS_ XXXcode specifying additional information about the error if MiniportReconfigurewill 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 MiniportInitializewith NdisMSetAttributesor NdisMSetAttributesEx.

WrapperConfigurationContext

Specifies a handle used only during initialization for calls to Ndis XXXconfiguration and initialization functions. For example, this handle is a required parameter to NdisOpenConfigurationand the NdisImmediateRead XXXand NdisImmediateWrite XXXfunctions.

Return Values

MiniportReconfigureeither 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, MiniportReconfiguremight be called from MiniportInitializeto reconfigure a network adapter to new parameters returned by one of the Ndis XXXbus-relative configuration functions. For example, a MiniportReconfigurefunction might be used to support plug-and-play network adapters or software-configurable network adapters.

Because an internal MiniportReconfigurefunction is called from MiniportInitialize, no other driver request can be outstanding when MiniportReconfigureis 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, MiniportReconfigurecan 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.