OID_WWAN_DELETE_MAC
OID_WWAN_DELETE_MAC requests the miniport driver to delete the NDIS port specified in the NDIS_WWAN_MAC_INFO parameter. The NDIS port should have been created earlier using OID_WWAN_CREATE_MAC.
Miniport drivers must process the set request asynchronously, initially returning NDIS_STATUS_PENDING to the original request, and later completing the request with NDIS_STATUS_SUCCESS.
Query requests are not supported.
Remarks
Miniport drivers must process requests to delete (deactivate) NDIS ports asynchronously in order to prevent deadlocks.
OID_WWAN_DELETE_MAC requests sent to delete the default port will fail with the NDIS status error code NDIS_STATUS_INVALID_PORT.
Upon receiving an OID_WWAN_DELETE_MAC request, miniport drivers should deactivate the PDP context associated with the port, if it has not already been deactivated. This is because a surprise removal event could occur. Deactivating the PDP context at such time will ensure that the modem and the miniport driver remain in a good state.
When the driver receives a surprise removal, the driver blocks and cancels all further OIDs. This means that the driver filters out OID_WWAN_DELETE_MAC even though Windows sends a call with OID_WWAN_DELETE_MAC as part of the FILTER_DETACH call.
Requirements
Version |
Available in Windows 8.1 and later versions of Windows. |
Header |
Ntddndis.h (include Ndis.h) |