structure MBN_INTERFACE_CAPS (mbnapi.h)
Important
À compter de Windows 10 version 1803, les API Win32 décrites dans cette section sont remplacées par les API Windows Runtime dans l’espace de noms Windows.Networking.Connectivity.
La structure MBN_INTERFACE_CAPS représente les fonctionnalités de l’interface. Cette structure est retournée par la méthode GetInterfaceCapabilityd’IMbnInterface.
Syntaxe
typedef struct MBN_INTERFACE_CAPS {
MBN_CELLULAR_CLASS cellularClass;
MBN_VOICE_CLASS voiceClass;
ULONG dataClass;
BSTR customDataClass;
ULONG gsmBandClass;
ULONG cdmaBandClass;
BSTR customBandClass;
ULONG smsCaps;
ULONG controlCaps;
BSTR deviceID;
BSTR manufacturer;
BSTR model;
BSTR firmwareInfo;
} MBN_INTERFACE_CAPS;
Membres
cellularClass
Valeur MBN_CELLULAR_CLASS qui spécifie la technologie cellulaire utilisée par l’appareil.
voiceClass
Valeur MBN_VOICE_CLASS qui spécifie la façon dont les appels vocaux sont gérés.
dataClass
Combinaison OR au niveau du bit de valeurs MBN_DATA_CLASS qui spécifie les services de données pris en charge. Pour les appareils GSM, seuls les services de données basés sur GSM peuvent être présents, c’est-à-dire que seuls GPRS, EDGE, UMTS, LTE et HSDPA sont des valeurs valides pour les appareils GSM.
Pour les appareils CDMA, seuls les services de données liés à CDMA seront présents, c’est-à-dire que seuls 1xRTT, 1xEV-DO et 1xEV-DO RevA sont des valeurs valides pour les appareils CDMA. 1xEV-DO RevB est réservé à une utilisation future.
Ce champ a la valeur de bit MBN_DATA_CLASS_CUSTOM définie si la classe de données d’une autre classe de données qui n’est pas définie dans l’énumération est également prise en charge par l’appareil. Si MBN_DATA_CLASS_CUSTOM est défini, les informations relatives à la classe de données personnalisées sont disponibles dans le champ customDataClass .
customDataClass
Contient le nom de la classe de données personnalisée. Si le MBN_DATA_CLASS_CUSTOM bit de dataClass n’est pas défini, la chaîne est NULL. Sinon, l’appelant doit libérer cette chaîne en appelant SysFreeString.
gsmBandClass
Champ bit qui spécifie les bandes de fréquences prises en charge par l’appareil GSM. MBN_BAND_CLASS_I via MBN_BAND_CLASS_X et MBN_BAND_CLASS_CUSTOM sont des valeurs valides. Ces valeurs sont définies par MBN_BAND_CLASS. Si gsmBandClass est défini sur MBN_BAND_CLASS_CUSTOM, des informations supplémentaires sur la classe de bande s’affichent dans customBandClass.
Le tableau suivant fournit des informations supplémentaires sur les valeurs MBN_BAND_CLASS .
| valeur MBN_BAND_CLASS | Spectre désigné | Nom de l’industrie | Liaison montante (MS vers BTS) | Liaison descendante (BTS vers MS) | Régions |
|---|---|---|---|---|---|
| MBN_BAND_CLASS_I | UMTS2100 | IMT | 1920-1980 | 2110-2170 | Europe, Corée, Japon Chine |
| MBN_BAND_CLASS_II | UMT21900 | PCS1900 | 1850-1910 | 1930-1990 | Amérique du Nord, Amérique latine |
| MBN_BAND_CLASS_III | UMTS1800 | DCS1800 | 1710-1785 | 1805-1880 | Europe, Chine |
| MBN_BAND_CLASS_IV | AWS | AWS, 1.7/2.1 | 1710-1785 | 2110-2155 | Amérique du Nord, Amérique latine |
| MBN_BAND_CLASS_V | UMTS850 | GSM850 | 824-849 | 869-894 | Amérique du Nord, Amérique latine |
| MBN_BAND_CLASS_VI | UMTS800 | UMTS800 | 830-840 | 875-885 | Japon |
| MBN_BAND_CLASS_VII | UMTS2600 | UMTS2600 | 2500-2570 | 2620-2690 | Europe |
| MBN_BAND_CLASS_VIII | UMTS900 | EGSM900 | 880-915 | 925-960 | Europe, Chine |
| MBN_BAND_CLASS_IX | UMTS1700 | UMTS1700 | 1750-1770 | 1845-1880 | Japon |
| MBN_BAND_CLASS_X | 1710-1770 | 2110-2170 |
cdmaBandClass
Champ bit qui spécifie les bandes de fréquences prises en charge par l’appareil CDMA. MBN_BAND_CLASS_0 via MBN_BAND_CLASS_XVII, MBN_BAND_CLASS_NONE et MBN_BAND_CLASS_CUSTOM sont des valeurs valides. Ces valeurs sont définies par MBN_BAND_CLASS. Si cdmaBandClass a la valeur MBN_BAND_CLASS_CUSTOM, des informations supplémentaires sur la classe de bande s’affichent dans customBandClass.
Le tableau suivant fournit des informations supplémentaires sur les valeurs MBN_BAND_CLASS.
| valeur MBN_BAND_CLASS | Nom du secteur d’activité | Liaison montante (MS vers BTS) | Liaison descendante (BTS vers MS) |
|---|---|---|---|
| MBN_BAND_CLASS_0 | 800MHx Cellular | 824.025.844.995 | 869.025.889.995 |
| MBN_BAND_CLASS_I | Bande de 1900 MHz | 1850-1910 | 1930-1990 |
| MBN_BAND_CLASS_II | Bande TACS | 872.025.914.9875 | 917.0125.959.9875 |
| MBN_BAND_CLASS_III | Bande JTACS | 887.0125.924.9875 | 832.0125.869.9875 |
| MBN_BAND_CLASS_IV | Bande PCS coréenne | 1750-1780 | 1840-1870 |
| MBN_BAND_CLASS_V | Bande de 450 MHz | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_VI | Bande de 2 GHz | 1920-1979.950 | 2110-2169.950 |
| MBN_BAND_CLASS_VII | Bande de 700 MHz | 776-794 | 746-764 |
| MBN_BAND_CLASS_VIII | Bande de 1800 MHz | 1710-1784.950 | 1805-1879.95 |
| MBN_BAND_CLASS_IX | Bande de 900 MHz | 880-914-950 | 925-959.950 |
| MBN_BAND_CLASS_X | Bande secondaire de 800 MHz | 806-900.975 | 851-939.975 |
| MBN_BAND_CLASS_XI | Bande PAMR européenne de 400 MHz | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_XII | Bande PAMR de 800 MHz | 870.125-875.9875 | 915.0125-920.9875 |
| MBN_BAND_CLASS_XIII | Bande d’extension IMT200 2,5 GHz | 2500-2570 | 2620-2690 |
| MBN_BAND_CLASS_XIV | BANDE US PCS 1,9 GHz | 1850-1915 | 1930-1995 |
| MBN_BAND_CLASS_XV | Bande AWS | 1710-1755 | 2110-2155 |
| MBN_BAND_CLASS_XVI | Bande 2,5 GHz aux États-Unis | 2502-2568 | 2624-2690 |
| MBN_BAND_CLASS_XVII | Bande de liaison vers le transfert uniquement 2,5 GHz aux États-Unis | 2624-2690 |
customBandClass
Contient le nom de la classe de bande personnalisée. Si le MBN_BAND_CLASS_CUSTOM bit de cdmaBandClass et gsmBandClass n’est pas défini, la chaîne est NULL. Sinon, l’appelant doit libérer cette chaîne en appelant SysFreeString.
smsCaps
Combinaison or au niveau du bit de valeurs MBN_SMS_CAPS qui spécifie les fonctionnalités SMS.
controlCaps
Combinaison ou au niveau du bit de valeurs MBN_CTRL_CAPS qui représente les fonctionnalités de contrôle haut débit mobile pour cette interface.
deviceID
Contient l’ID de l’appareil. Pour les appareils GSM, il doit s’agir de l’IMEI (jusqu’à 15 chiffres). Pour les appareils CDMA, il doit s’agir du numéro ESN (11 chiffres) / MEID (17 chiffres). La longueur maximale de la chaîne est MBN_DEVICEID_LEN. Pour la définition de MBN_DEVICEID_LEN, consultez MBN_INTERFACE_CAPS_CONSTANTS. L’appelant doit libérer cette chaîne en appelant SysFreeString.
manufacturer
Contient le nom du fabricant de l’appareil. Cette chaîne peut être vide. La longueur maximale de la chaîne est MBN_MANUFACTURER_LEN. Pour la définition de MBN_MANUFACTURER_LEN, consultez MBN_INTERFACE_CAPS_CONSTANTS. L’appelant doit libérer cette chaîne en appelant SysFreeString.
model
Contient le modèle d’appareil. Cette chaîne peut être vide. La longueur maximale de cette chaîne est MBN_MODEL_LEN. Pour la définition de MBN_MODEL_LEN, consultez MBN_INTERFACE_CAPS_CONSTANTS. L’appelant doit libérer cette chaîne en appelant SysFreeString.
firmwareInfo
Contient les informations spécifiques au microprogramme pour cet appareil. Cette chaîne peut être vide. La longueur maximale de la chaîne est MBN_FIRMWARE_LEN. Pour la définition de MBN_FIRMWARE_LEN, consultez MBN_INTERFACE_CAPS_CONSTANTS. L’appelant doit libérer cette chaîne en appelant SysFreeString.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Aucun pris en charge |
| En-tête | mbnapi.h |