OID_WWAN_SLOT_INFO

OID_WWAN_SLOT_INFO retrieves a high-level aggregated status of a specified UICC slot and the card within it (if any). It may also be used to deliver an unsolicited notification when the status of one of the slots changes.

Miniport drivers must process query requests asynchronously, initially returning NDIS_STATUS_INDICATION_REQUIRED to the original request before later sending an NDIS_STATUS_WWAN_SLOT_INFO status notification containing an NDIS_WWAN_SLOT_INFO structure, which in turn contains a WWAN_SLOT_INFO structure, to provide information about the overall modem system capability.

Query requests specify NDIS_WWAN_GET_SLOT_INFO structure as input. The miniport driver should return the slot status according to the slot ID specified in the SlotIndex member of the WWAN_GET_SLOT_INFO structure.

The following diagram illustrates a query request.

Diagram that shows the process of a slot status query.

Set requests are not applicable.

An NDIS_STATUS_WWAN_SLOT_INFO notification with a NDIS_WWAN_SLOT_INFO structure is sent to host when the slot/card state changes.

Remarks

The host uses OID_WWAN_SLOT_INFO to query the status of a specific slot on the modem. This OID is not executor-specific and may be sent to any NDIS instance belonging to one modem. The slot state represents a summary of both the slot and card state.

The set of reported states is constrained by the capability of the slot hardware. In the most restrictive case, the slot hardware may only be able to determine that a card is present when it is powered on and active—in such a case the OffEmpty and Off states will not be reported.

OID_WWAN_READY_INFO and OID_WWAN_SLOT_INFO perform the same core function of retrieving the device ready-state of a SIM card slot; however, OID_WWAN_READY_INFO is a per-executor command whereas OID_WWAN_SLOT_INFO could be used on any physical instance (executor) and is expected to return the appropriate slot state even if it is not mapped to any executors at the moment.

Requirements

Version

Windows 10, version 1703

Header

Ntddndis.h (include Ndis.h)

See also

NDIS_STATUS_WWAN_SLOT_INFO

NDIS_WWAN_SLOT_INFO

WWAN_SLOT_INFO

NDIS_WWAN_GET_SLOT_INFO

WWAN_GET_SLOT_INFO

WWAN_UICCSLOT_STATE

OID_WWAN_READY_INFO