Compartilhar via


estrutura NDIS_WWAN_PREFERRED_PROVIDERS (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 operações definidas . Os drivers de miniport devem definir o cabeçalho com os mesmos valores quando enviarem a estrutura de dados para o serviço MB.

Submember 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 miniporte deve definir isso como WWAN_STATUS_SUCCESS para eventos não solicitados (NDIS_STATUS_INDICATION::RequestId = 0). WWAN_STATUS_SUCCESS também é definido para a execução bem-sucedida do NDIS_WWAN_SET_PREFERRED_PROVIDERS.

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

Valor Significado
WWAN_STATUS_PIN_REQUIRED O dispositivo requer entrada de valor de PIN.
WWAN_STATUS_READ_FAILURE Falha ao ler informações do dispositivo ou do SIM cartão ou ambos. Por exemplo, a cartão sim não tem informações de provedores preferenciais provisionadas.
WWAN_STATUS_BAD_SIM SIM inválido 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 definida .

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. Os sinalizadores 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 para definir OID_WWAN_PREFERRED_PROVIDERS solicitações deve conter zero elementos no PreferenceListHeader.

Requisitos

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

Confira também

NDIS_OBJECT_HEADER

WWAN_LIST_HEADER