Compartilhar via


NDIS_WWAN_PREFERRED_PROVIDERS estrutura (ndiswwan.h)

A estrutura NDIS_WWAN_PREFERRED_PROVIDERS representa uma lista de provedores preferenciais, incluindo o número de provedores na lista.

Sintaxe

typedef struct _NDIS_WWAN_PREFERRED_PROVIDERS {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_LIST_HEADER   PreferredListHeader;
} NDIS_WWAN_PREFERRED_PROVIDERS, *PNDIS_WWAN_PREFERRED_PROVIDERS;

Membros

Header

O cabeçalho com informações de tipo, revisão e tamanho sobre a estrutura NDIS_WWAN_PREFERRED_PROVIDERS. O Serviço MB define o cabeçalho com os valores mostrados na tabela a seguir quando envia a estrutura de dados para o driver de miniporto para definir operações de. Os drivers de miniporto devem definir o cabeçalho com os mesmos valores quando enviarem a estrutura de dados para o serviço MB.

Submembro de cabeçalho Valor
Tipo NDIS_OBJECT_TYPE_DEFAULT
Revisão NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1
Tamanho sizeof(NDIS_WWAN_PREFERRED_PROVIDERS)
 

Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.

uStatus

O driver de miniporto deve definir isso como WWAN_STATUS_SUCCESS para eventos não solicitados (NDIS_STATUS_INDICATION::RequestId = 0). WWAN_STATUS_SUCCESS também está definido para a execução bem-sucedida do NDIS_WWAN_SET_PREFERRED_PROVIDERS.

A tabela a seguir mostra outros códigos de status de erro possíveis (outros membros não precisam ser atualizados pelo driver de miniporto).

Valor Significado
WWAN_STATUS_PIN_REQUIRED O dispositivo requer entrada de valor PIN.
WWAN_STATUS_READ_FAILURE Falha ao ler informações do dispositivo ou cartão SIM ou ambos. Por exemplo, o cartão SIM não tem informações de provedores preferenciais provisionadas.
WWAN_STATUS_BAD_SIM SIM incorreto detectado.
WWAN_STATUS_SIM_NOT_INSERTED SIM não inserido no dispositivo.
WWAN_STATUS_NO_DEVICE_SUPPORT Não há suporte para uma solicitação.

PreferredListHeader

Um objeto WWAN_LIST_HEADER formatado que representa uma lista de provedores preferenciais, incluindo o número de provedores na lista.

Eles apontam para a lista de WWAN_PROVIDER2 usando a estrutura WWAN_LIST_HEADER. sinalizadores de WwanDataClass descrevem a preferência da tecnologia de acesso a dados específica e podem ser definidos como qualquer combinação dentro de sua própria classe celular.

A resposta ao conjunto de OID_WWAN_PREFERRED_PROVIDERS solicitações deve conter zero elementos no PreferenceListHeader.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Windows 7 e versões posteriores do Windows.
cabeçalho ndiswwan.h (inclua Ndiswwan.h)

Consulte também

NDIS_OBJECT_HEADER

WWAN_LIST_HEADER