OID_WWAN_SMS_READ

OID_WWAN_SMS_READ reads SMS text messages stored in the MB device, or Subscriber Identity Module (SIM card), or any other auxiliary non-volatile memory or memories.

Set requests are not supported.

Miniport drivers must process query requests asynchronously, initially returning NDIS_STATUS_INDICATION_REQUIRED to the original request, and later sending an NDIS_STATUS_WWAN_SMS_RECEIVE status notification containing an NDIS_WWAN_SMS_READ structure to provide the SMS messages requested that was initially provided by the caller when completing query requests.

Callers requesting to read SMS text messages provide an NDIS_WWAN_SMS_READ structure to indicate which SMS messages the caller wants the miniport to return.

Remarks

For more information about using this OID, see WWAN SMS Operations.

When processing this OID, miniport drivers can access the Subscriber Identity Module (SIM card), but should not access the provider network.

OID_WWAN_SMS_READ supports reading both PDU-mode and CDMA-mode SMS text messages, depending on the capabilities of the device.

Miniport drivers may receive requests to read SMS text messages based on an index, or to read all SMS text messages. Read requests may consist of any one of the basic filters such as new (unread) messages, old (read) messages, draft messages, or sent messages.

Miniport drivers that implement SMS text message functionality must support the reading of new messages using the basic filter for WwanSmsFlagNew. All other filter types are optional to support.

Miniport drivers must logically project a single SMS text message store across all available physically different SMS text message stores.

Miniport drivers should return NDIS_STATUS_NOT_SUPPORTED if they do not support SMS text messages.

Requirements

Version

Available in Windows 7 and later versions of Windows.

Header

Ntddndis.h (include Ndis.h)

See also

NDIS_WWAN_SMS_READ

WWAN SMS Operations