NDIS_WWAN_NETWORK_BLACKLIST structure (ndiswwan.h)

Article
05/26/2021

Important

Bias-free communication

Microsoft supports a diverse and inclusive environment. This article contains references to terminology that the Microsoft style guide for bias-free communication recognizes as exclusionary. The word or phrase is used in this article for consistency because it currently appears in the software. When the software is updated to remove the language, this article will be updated to be in alignment.

The NDIS_WWAN_NETWORK_BLACKLIST structure describes a mobile broadband (MBB) device's list of network blacklist providers.

Syntax

typedef struct _NDIS_WWAN_NETWORK_BLACKLIST {
  NDIS_OBJECT_HEADER          Header;
  WWAN_STATUS                 uStatus;
  WWAN_NETWORK_BLACKLIST_INFO NetworkBlacklistInfo;
} NDIS_WWAN_NETWORK_BLACKLIST, *PNDIS_WWAN_NETWORK_BLACKLIST;

Members

Header

The header with type, revision, and size information about the NDIS_WWAN_NETWORK_BLACKLIST structure. The MB Service sets the header with the values that are shown in the following table when it sends the data structure to the miniport driver for set operations. Miniport drivers must set the header with the same values when they send the data structure to the MB service.

Header submember	Value
Type	NDIS_OBJECT_TYPE_DEFAULT
Revision	NDIS_WWAN_NETWORK_BLACKLIST_REVISION_1
Size	sizeof(NDIS_WWAN_NETWORK_BLACKLIST)

For more information about these members, see NDIS_OBJECT_HEADER.

uStatus

The status of system capability. The following table shows the possible values for this member.

Value	Meaning
WWAN_STATUS_SUCCESS	The operation succeeded.
WWAN_STATUS_BUSY	The operation failed because the device was busy. In the absence of any explicit information from the function to clear this condition, the host can use subsequent actions by the function (e.g. notifications or command completions) as a hint to retry the failed operation.
WWAN_STATUS_FAILURE	The operation failed.
WWAN_STATUS_NO_DEVICE_SUPPORT	The operation failed because the device does not support this OID.

NetworkBlacklistInfo

A formatted WWAN_NETWORK_BLACKLIST_INFO structure that contains a list of network blacklist providers for the modem.

Remarks

This structure is used in the NDIS_STATUS_WWAN_NETWORK_BLACKLIST status notification in response to a previous OID_WWAN_NETWORK_BLACKLIST Query or Set request.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1703
Header	ndiswwan.h