struttura NDIS_WWAN_PREFERRED_PROVIDERS (ndiswwan.h)
La struttura NDIS_WWAN_PREFERRED_PROVIDERS rappresenta un elenco di provider preferiti, incluso il numero di provider nell'elenco.
Sintassi
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;
Members
Header
Intestazione con informazioni su tipo, revisione e dimensioni relative alla struttura NDIS_WWAN_PREFERRED_PROVIDERS. Il servizio MB imposta l'intestazione con i valori visualizzati nella tabella seguente quando invia la struttura dei dati al driver miniport per le operazioni set . I driver Miniport devono impostare l'intestazione con gli stessi valori quando inviano la struttura dei dati al servizio MB.
| Sottomembero intestazione | Valore |
|---|---|
| Tipo | NDIS_OBJECT_TYPE_DEFAULT |
| Revisione | NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1 |
| Dimensione | sizeof(NDIS_WWAN_PREFERRED_PROVIDERS) |
Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.
uStatus
Il driver Miniport deve impostarlo su WWAN_STATUS_SUCCESS per gli eventi non richiesti (NDIS_STATUS_INDICATION::RequestId = 0). WWAN_STATUS_SUCCESS viene impostato anche per l'esecuzione corretta del NDIS_WWAN_SET_PREFERRED_PROVIDERS.
La tabella seguente mostra altri codici di stato di errore possibili (altri membri non devono essere aggiornati dal driver miniport).
| Valore | Significato |
|---|---|
| WWAN_STATUS_PIN_REQUIRED | Il dispositivo richiede l'input del valore PIN. |
| WWAN_STATUS_READ_FAILURE | Impossibile leggere le informazioni dal dispositivo o dalla scheda SIM o da entrambi. Ad esempio, la scheda SIM non dispone di informazioni sui provider preferiti di cui è stato effettuato il provisioning. |
| WWAN_STATUS_BAD_SIM | Rilevata sim non valida. |
| WWAN_STATUS_SIM_NOT_INSERTED | SIM non inserita nel dispositivo. |
| WWAN_STATUS_NO_DEVICE_SUPPORT | Una richiesta set non è supportata. |
PreferredListHeader
Oggetto WWAN_LIST_HEADER formattato che rappresenta un elenco di provider preferiti, incluso il numero di provider nell'elenco.
Questi punti all'elenco di WWAN_PROVIDER2 usando la struttura WWAN_LIST_HEADER. I flag WwanDataClass descrivono la preferenza della tecnologia di accesso ai dati specifica e possono essere impostati su qualsiasi combinazione all'interno della propria classe cellulare.
La risposta per impostare OID_WWAN_PREFERRED_PROVIDERS richieste deve contenere zero elementi in PreferenceListHeader.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| Intestazione | ndiswwan.h (include Ndiswwan.h) |