OID_WWAN_VISIBLE_PROVIDERS

OID_WWAN_VISIBLE_PROVIDERS restituisce un elenco di provider di rete attualmente visibili all'interno dell'intervallo del dispositivo MB.

Le richieste set non sono supportate.

I driver Miniport devono elaborare le richieste di query in modo asincrono, restituendo inizialmente NDIS_STATUS_INDICATION_REQUIRED alla richiesta originale e successivamente inviando una notifica di stato NDIS_STATUS_WWAN_VISIBLE_PROVIDERS contenente una struttura di NDIS_WWAN_VISIBLE_PROVIDERS per fornire informazioni sui provider di rete visibili durante il completamento delle richieste di query.

Le richieste di query specificano NDIS_WWAN_GET_VISIBLE_PROVIDERS struttura come input. Quando il membro Action in WWAN_GET_VISIBLE_PROVIDERS è impostato su WWAN_GET_VISIBLE_PROVIDERS_ALL il miniport deve restituire tutti i provider visibili. Quando il membro Action in WWAN_GET_VISIBLE_PROVIDERS è impostato su WWAN_GET_VISIBLE_PROVIDERS_MULTICARRIER il miniport deve restituire solo provider multi-carrier visibili che possono essere impostati come provider home.

L'elenco dei provider visibili restituito dal dispositivo deve avere lo stato del provider impostato correttamente per ognuno dei provider. Ad esempio, i provider preferiti multicarrier devono essere contrassegnati come WWAN_PROVIDER_STATE_PREFERRED_MULTICARRIER, il provider home corrente se deve essere contrassegnato come WWAN_PROVIDER_STATE_HOME, Il provider registrato corrente se presente deve essere contrassegnato come WWAN_PROVIDER_STATE_REGISTERED.

I membri Rssi e ErrorRate della struttura WWAN_PROVIDER2 devono essere impostati se disponibili.

Commenti

Per altre informazioni sull'uso di questo OID, vedere Operazioni del provider WWAN.

I driver Miniport possono accedere al Modulo identità sottoscrittore (scheda SIM) durante l'elaborazione delle operazioni di query, ma non devono accedere alla rete del provider.

I driver Miniport devono impostare il membro VisibleListHeader.ElementType su WwanStructProvider.

Per le reti basate su CDMA, il driver miniport deve restituire solo il provider home, se una delle reti nell'elenco di roaming preferito (PRL) è attualmente visibile. Per le reti basate su GSM, è possibile che nell'elenco dei provider visibili siano presenti più provider.

I dispositivi che non supportano l'analisi dei provider visibili durante la connessione devono restituire il valore di errore WWAN_STATUS_BUSY nel membro uStatus della struttura NDIS_WWAN_VISIBLE_PROVIDERS.

Sia i dispositivi basati su GSM che i dispositivi basati su CDMA devono supportare l'analisi dei provider visibili in modalità registrata. Tuttavia, i driver miniport non sono necessari per supportare l'analisi del provider visibile mentre un contesto PDP (Packet Data Protocol) è attivo (ad esempio, il dispositivo è connesso alla rete del provider).

Requisiti

Versione

Disponibile in Windows 7 e versioni successive di Windows.

Intestazione

Ntddndis.h (include Ndis.h)

Vedi anche

NDIS_WWAN_VISIBLE_PROVIDERS

NDIS_STATUS_WWAN_VISIBLE_PROVIDERS

Operazioni del provider WWAN