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) |