Partager via


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