MB 프로비전된 컨텍스트 작업
각 통신사의 네트워크에 대한 APN 구성이 서로 다르기 때문에 셀룰러 연결 가능 디바이스에는 프로비저닝이 매우 중요합니다. APN 구성은 일반적으로 다음 두 가지 범주로 분할될 수 있습니다.
- OS 위에 해당 연결이 필요한 애플리케이션 또는 클라이언트가 있기 때문에 OS에 알려진 APN 구성입니다.
- OS 및 해당 클라이언트에서 활용하지 않는 연결의 모뎀에서 내부적으로 사용되기 때문에 OS에 알려지지 않은 APN 구성입니다.
이상적으로 모뎀은 OS에서 알 필요가 없는 APN 구성만 저장해야 합니다. 그러나 IHV 및 OEM 파트너는 전통적으로 모뎀에서 OS에 알려진 구성인 인터넷 및 구매 APN을 제공했습니다. Windows 10 버전 1703 릴리스 이전에는 Windows에서 인터넷 및 구매 APN 구성만 모뎀에서 읽어 인터넷 연결을 설정합니다. Windows 10 버전 1703부터 모뎀의 APN 구성을 Windows에서 관리해야 하는 추가 사례가 있을 수 있습니다. 특히 OS에 사용자 설정 또는 셀룰러 구성을 변경하려는 OMA-DM과 같은 클라이언트가 있는 경우입니다. 이는 모뎀의 APN 구성에도 영향을 줄 수 있습니다. 예를 들어 IMS를 통해 SMS에 IMS APN을 사용하는 IMS 스택이 모뎀에 있을 수 있습니다. 일반적으로 이러한 연결은 OS에 노출되지 않지만 특정 시나리오에서는 IMS APN 구성을 변경해야 할 수 있습니다. 이 변경은 OS를 통해 수행할 수 있습니다. 이를 지원하기 위해 Windows 10 버전 1703부터 OS는 다양한 유형의 APN을 모뎀으로 구성할 수 있습니다.
USB 포럼의 MBIM 1.0 및 Microsoft NDIS에는 각각 OS가 모뎀에서 APN 구성을 설정하고 쿼리할 수 있도록 기존 CID 및 OID가 있습니다. MBIM 1.0의 경우 MBIM_CID_PROVISIONED_CONTEXT 통해 이 작업을 수행하는 반면 NDIS의 경우 OID_WWAN_PROVISIONED_CONTEXTS 통해 이 작업을 수행합니다. 그러나 기존 CID 및 OID는 전원 주기 또는 SIM 교환과 같은 다양한 상황에서 모뎀이 작동하는 방식에 대한 명확한 지침으로 설계되지 않았습니다. 앞으로 모뎀 프로비전 컨텍스트의 OS 구성 및 업데이트를 지원하려는 디바이스는 Windows 10 버전 1703에서 최신 버전의 CID 및 OID를 구현해야 합니다. 이전 버전과의 호환성을 보장하려면 1703보다 오래된 OS 버전에서 새 하드웨어를 지원하려는 IHV/OEM의 경우 기존 MBIM_CID_PROVISIONED_CONTEXT 계속 지원해야 하며 OID_WWAN_PROVISIONED_CONTEXTS. Windows 10 버전 1703부터 디바이스가 CID 및 OID의 새 버전을 지원하는 경우 OS는 최신 버전의 명령만 사용하여 모뎀에서 APN 컨텍스트 구성을 쿼리하고 설정합니다.
프로비전된 컨텍스트 작업에 대한 MB 인터페이스 업데이트
MBIM에는 모뎀에 저장된 컨텍스트를 검색하고 바꾸기 위한 명령이 있지만 프로필을 "사용하지 않도록 설정" 또는 "사용"하는 필드가 없습니다. 따라서 이 기능을 포함하려면 Windows 10 버전 1703에 대한 기존 MBIM_CID_PROVISIONED_CONTEXT 업데이트해야 합니다. MBIM에는 버전 관리 메커니즘이 없으므로 새 MSFT 독점 CID가 MBIM_CID_MS_PROVISIONED_CONTEXT_V2 정의됩니다.
서비스 이름 = 기본 커넥트 확장
UUID = UUID_BASIC_CONNECT_EXTENSIONS
UUID 값 = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf
| CID | 명령 코드 | Minimum OS Version |
|---|---|---|
| MBIM_CID_MS_PROVISIONED_CONTEXT_V2 | 1 | Windows 10 버전 1703 |
MBIM_CID_MS_PROVISIONED_CONTEXT_V2
설명
MBIM 1.0은 OS 및 해당 상위 클라이언트가 모뎀에서 프로비전된 컨텍스트를 관리하기 위한 MBIM_CID_PROVISIONED_CONTEXT 정의했지만 Windows는 일반적으로 모뎀의 컨텍스트만 쿼리했지만 OS에서 설정하지는 않았습니다. Windows 10 버전 1703부터 OS가 모뎀에서 컨텍스트를 구성할 수 있어야 하는 필요성이 증가하고 있습니다. 예를 들어 OS에 불투명한 모뎀에 IMS 스택이 있는 경우 OS는 모뎀에서 사용해야 하는 IMS APN을 지정할 수 있어야 합니다. 각 모뎀 IHV는 모뎀에 컨텍스트를 저장하는 고유한 방법을 가질 수 있으므로 OS에서 MBIM_CID_PROVISIONED_CONTEXT 제안할 수 있는 방식으로 ContextId 수준에서 프로필을 관리하는 것은 불가능합니다. 대신 OS의 관점에서 각 컨텍스트 형식에 사용할 컨텍스트를 규정하는 것이 더 중요합니다. 모뎀에 있는 기존 프로비전된 컨텍스트 수에 관계없이 IMS 예제로 돌아가면 OS가 MBIM_CONTEXT_TYPE = IMS가 있는 컨텍스트를 설정한 경우 모뎀에서 시작된 모든 IMS 트래픽은 해당 컨텍스트에서만 시도되어야 합니다.
MBIM 1.0은 MBIM_CID_PROVISIONED_CONTEXT 삽입된 SIM 카드 공급자 ID(MCC/MNC 쌍)와 일치하는 컨텍스트에서만 쿼리를 호출할 수 있도록 지정합니다. 요청 설정의 경우 MBIM_CID_PROVISIONED_CONTEXT 저장하려는 컨텍스트의 공급자 ID를 지정할 수 있습니다. MBIM_CID_MS_PROVISIONED_CONTEXT_V2 MBIM 1.0과 유사하지만 다른 동작을 지정합니다. 각 쿼리에 대해 OS는 모뎀이 삽입된 SIM 카드 공급자 ID와 일치하는 컨텍스트만 반환할 것으로 계속 예상합니다. Set의 경우 명령은 더 이상 SIM 카드 현재 공급자 ID와 일치하지 않는 컨텍스트를 설정하도록 OS를 사용하도록 설정하지 않습니다. Set 요청은 제공된 SIM 카드 현재 공급자 ID에 대한 컨텍스트를 만드는 것입니다. 예를 들어 사용자는 SIM 1에서 SIM 2로 교환한 다음 다시 SIM 1로 바꿉니다. 첫 번째 SIM 교환 중에 모뎀은 SIM 2에 대한 컨텍스트를 로드하기 전에 모든 컨텍스트를 확인해야 합니다. 사용자가 SIM 1로 다시 교환하는 경우 SIM 1의 팩터리 기본 구성을 복원해야 합니다. 모뎀이 SIM 스왑에서 런타임 구성을 저장할 것으로 예상되지 않습니다.
다음 다이어그램에서는 사용자가 SIM에서 다른 SIM으로 교환한 다음 첫 번째 SIM으로 다시 교환하는 경우의 샘플 흐름을 보여 줍니다.
모뎀을 미리 구성한 OEM 및 IHV는 OS 또는 사용자가 모뎀의 컨텍스트 설정을 원래 설정으로 복원하려는 경우 원래 팩터리 구성을 유지해야 합니다. 현재 삽입된 SIM의 공급자 ID에 대한 원래 팩터리 컨텍스트만 복원해야 합니다. 원래 팩터리 설정 미리 구성된 컨텍스트는 OS의 구성에 의해 덮어쓰여서는 안 됩니다. 다음 다이어그램은 사용자가 팩터리 설정을 복원하도록 선택하는 경우의 예제 흐름입니다.
SIM이 없거나 잠겨 있거나 공급자 ID에 액세스할 수 없는 경우 모뎀이 쿼리 또는 요청 설정에 실패할 것으로 예상됩니다. 모뎀에는 공급자 ID당 CONTEXT_TYPE 한 컨텍스트만 있어야 합니다. IHV 또는 OEM이 모뎀에서 모뎀 컨텍스트를 미리 구성하기로 결정한 경우 이를 위해 선택한 각 공급자에 대해 컨텍스트가 올바르게 구성되었는지 확인하는 것이 중요합니다. 삽입된 SIM 카드 미리 구성된 IHV 컨텍스트가 없는 경우 모뎀에는 OS 구성이 없는 컨텍스트가 없어야 합니다. IHV 및 OEM은 MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceModemProvisioned를 확인하여 OS가 모뎀의 컨텍스트를 연결에 사용하고 있는 경우 Windows의 APN 데이터베이스에서 덮어쓰지 않도록 해야 합니다.
모뎀 맵이 컨텍스트를 처리하고 기존 MBIM_CID_PROVISIONED_CONTEXT 통해 다시 표시하는 방법은 각 IHV에 달려 있으며 이 설명서의 범위를 벗어 난다.
새 MBIM_CID_MS_PROVISONED_CONTEXT_V2 명령은 MBIM 1.0의 기존 MBIM_CID_PROVISIONED_CONTEXT 명령과 거의 동일하지만 몇 가지가 추가되었습니다. 첫 번째는 OS에 모뎀의 컨텍스트 형식과 연결된 컨텍스트를 사용하거나 사용하지 않도록 설정하는 기능을 제공합니다. 모뎀에서 컨텍스트를 사용하지 않도록 설정하면 모뎀은 OS에 인식되지 않은 경우에도 네트워크와의 연결에 저장된 컨텍스트를 사용하지 않을 것으로 예상됩니다. OS가 모뎀에서 비활성화된 컨텍스트와 일치하는 연결을 요청하는 경우 모뎀은 네트워크에 신호를 표시하지 않고 즉시 요청에 실패해야 합니다. 일치 프로세스는 MBIM_MS_CONTEXT_V2 구조체의 모든 필드와 일치해야 합니다.
MBIM 1.0의 MBIM_CONTEXT_IP_TYPE 구조체는 MBIM_CID_CONNECT 경우에만 사용됩니다. MBIM_CID_MS_PROVISIONED_CONTEXT_V2 Microsoft는 각 컨텍스트에 대한 매개 변수 중 하나로 IP 형식을 추가했습니다. 모뎀은 지정된 컨텍스트에 대해 구성되지 않은 경우 MBIMContextIPTypeDefault를 보고해야 합니다.
Windows 10 버전 1703에서는 MBIM_CID_MS_PROVISIONED_CONTEXT_V2 지원하는 새 하드웨어를 사용하여 레거시 MBIM_CID_PROVISIONED_CONTEXT 자사 구성 요소에서 사용되지 않습니다. MBIM_CID_PROVISIONED_CONTEXT 보내는 다른 레거시 클라이언트/OS 구성 요소가 있는 경우 모뎀은 Windows 10 버전 1703 이전 버전의 Windows에서와 마찬가지로 결과를 반환해야 합니다.
쿼리
MBIM_MS_PROVISIONED_CONTEXTS_INFO 쿼리 및 InformationBuffer의 전체 메시지 설정 모두에서 반환됩니다.
쿼리의 경우 InformationBuffer는 null입니다.
설정
Set의 경우 InformationBuffer에는 MBIM_MS_SET_PROVISIONED_CONTEXT_V2 구조체가 포함됩니다. 설정 작업에서 각 모뎀 IHV는 컨텍스트 스토리지를 관리하는 독점적인 방법을 가질 수 있으므로 OS는 더 이상 ContextId 필드를 지정하지 않으며 모뎀이 컨텍스트를 적절한 슬롯에 매핑할 것으로 예상합니다. OS가 컨텍스트를 설정하는 경우 모뎀이 지정된 컨텍스트의 MBIM_CONTEXT_TYPE 일치하는 모든 연결에 사용할 것으로 예상합니다. MBIM_CONTEXT_TYPE 모뎀에서 인식되지 않는 경우 모뎀과 연결되지 않더라도 여전히 저장해야 합니다.
원치 않는 이벤트
Event InformationBuffer에는 MBIM_MS_PROVISIONED_CONTEXTS_INFO_V2 구조체가 포함되어 있습니다. 경우에 따라 프로비저닝된 컨텍스트 목록은 네트워크에서 OS의 MBIM_CID_MS_PROVISIONED_CONTEXT_V2 명령을 통과하지 않는 OTA(무선) 또는 SMS(Short Message Service)에 의해 업데이트됩니다. 함수는 프로비전된 컨텍스트 목록을 업데이트하고 그에 따라 태그 MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceOperatorProvisioned를 업데이트해야 합니다. 그런 다음 함수는 업데이트된 목록과 함께 이 이벤트를 사용하여 호스트에 업데이트에 대해 알려야 합니다.
매개 변수
| 연산 | 설정 | 쿼리 | 알림 |
|---|---|---|---|
| 명령 | MBIM_SET_MS_PROVISIONED_CONTEXT_V2 | 해당 없음 | 해당 없음 |
| 응답 | MBIM_MS_PROVISIONED_CONTEXT_INFO_V2 | MBIM_MS_PROVISIONED_CONTEXT_INFO_V2 | MBIM_MS_PROVISIONED_CONTEXT_INFO_V2 |
데이터 구조
쿼리
InformationBuffer는 NULL이어야 하며 InformationBufferLength는 0이어야 합니다.
설정
다음 MBIM_SET_MS_PROVISIONED_CONTEXT_V2 데이터 구조는 InformationBuffer에 사용됩니다.
| Offset | 크기 | 필드 | 형식 | 설명 |
|---|---|---|---|---|
| 0 | 4 | 연산 | MBIM_MS_CONTEXT_OPERATIONS | SET 명령이 사용되는 작업의 유형을 지정합니다. MbimMsContextOperationDelete로 설정된 경우 지정된 MBIM_CONTEXT_TYPES 대한 컨텍스트를 삭제하고 MBIM_SET_MS_PROVISIONED_CONTEXT_V2 다른 모든 필드를 무시해야 합니다. MbimMsContextOperationRestoreFactory로 설정하면 OS에서 만들거나 수정된 모든 컨텍스트를 제거해야 하며, 미리 구성된 기본 팩터리 컨텍스트가 로드되고 MBIM_SET_MS_PROVISIONED_CONTEXT_V2 다른 모든 필드는 무시되어야 합니다. |
| 4 | 16 | ContextType | MBIM_CONTEXT_TYPES | 표시되는 컨텍스트의 형식을 지정합니다. 예를 들어 인터넷 연결, VPN(회사 네트워크에 대한 연결) 또는 VOIP(Voice-over-IP)가 있습니다. 자세한 내용은 MBIM_CONTEXT_TYPES 테이블을 참조하세요. |
| 20 | 4 | IPType | MBIM_CONTEXT_IP_TYPES | 표시되는 컨텍스트의 형식을 지정합니다. 예를 들어 인터넷 연결, VPN(회사 네트워크에 대한 연결) 또는 VOIP(Voice-over-IP)가 있습니다. 자세한 내용은 MBIM_CONTEXT_IP_TYPES 테이블을 참조하세요. |
| 24 | 4 | Enable | MBIM_MS_CONTEXT_ENABLE | 모뎀에서 컨텍스트를 사용할 수 있는지 여부를 지정합니다. MbimMsContextDisabled로 설정된 경우 컨텍스트와 일치하는 모든 OS 연결 요청은 네트워크에 신호를 표시하지 않고 실패해야 합니다. 자세한 내용은 MBIM_MS_CONTEXT_ENABLE 표를 참조하세요. |
| 28 | 4 | 로밍 | MBIM_MS_CONTEXT_ROAMING_CONTROL | 이 컨텍스트에 대해 로밍이 허용되는지 여부를 지정합니다. 자세한 내용은 MBIM_MS_CONTEXT_ROAMING_CONTROL 테이블을 참조하세요. |
| 32 | 4 | MediaType | MBIM_MS_CONTEXT_MEDIA_TYPE | 컨텍스트가 사용되는 미디어 전송 유형을 지정합니다. 자세한 내용은 MBIM_MS_CONTEXT_MEDIA_TYPE 테이블을 참조하세요. |
| 36 | 4 | Source | MBIM_MS_CONTEXT_SOURCE | 컨텍스트의 생성 원본을 지정합니다. 자세한 내용은 MBIM_MS_CONTEXT_SOURCE 테이블을 참조하세요. |
| 40 | 4 | AccessStringOffset | OFFSET | 네트워크에 액세스하기 위해 데이터 버퍼의 오프셋을 문자열인 AccessString으로 오프셋합니다. GSM 기반 네트워크의 경우 "data.thephone-company.com"과 같은 APN(액세스 지점 이름) 문자열입니다. CDMA 기반 네트워크의 경우 "#777"과 같은 특수 다이얼 코드 또는 "foo@thephone-company.com"와 같은 NAI(네트워크 액세스 식별자)일 수 있습니다. 이 멤버는 NULL이면 네트워크에서 기본 APN을 할당하도록 요청할 수 있습니다. 참고: 모든 네트워크가 이 NULL APN 규칙을 지원하지 않으므로 잘못된 APN으로 인한 연결 실패가 가능한 결과입니다. 문자열의 크기는 100자를 초과하면 안 됩니다. |
| 44 | 4 | AccessStringSize | SIZE(0..200) | AccessString에 사용되는 크기입니다. |
| 48 | 4 | UserNameOffset | OFFSET | 이 구조체의 시작 부분에서 인증할 사용자 이름을 나타내는 문자열 UserName으로 계산된 바이트 단위의 오프셋입니다. 이 멤버는 NULL일 수 있습니다. |
| 52 | 4 | UserNameSize | SIZE(0..510) | UserName에 사용되는 크기입니다. |
| 56 | 4 | PasswordOffset | OFFSET | 이 구조의 시작 부분에서 사용자 이름을 나타내는 문자열 암호로 계산된 바이트 단위의 오프셋입니다. 이 멤버는 NULL일 수 있습니다. |
| 60 | 4 | PasswordSize | SIZE(0..510) | 암호에 사용되는 크기입니다. |
| 64 | 4 | 압축 | MBIM_COMPRESSION | 헤더 및 데이터에 대한 데이터 연결에 사용할 압축을 지정합니다. 이 멤버는 GSM 기반 디바이스에만 적용됩니다. 호스트는 CDMA 기반 디바이스에 대해 이 멤버를 MBIMCompressionNone으로 설정합니다. 자세한 내용은 MBIM_COMPRESSION 테이블을 참조하세요. |
| 68 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | PDP 활성화에 사용할 인증 유형입니다. 자세한 내용은 MBIM_AUTH_PROTOCOL 테이블을 참조하세요. |
| 72 | 4 | DataBuffer | DATABUFFER | AccessString, UserName 및 Password를 포함하는 데이터 버퍼입니다. |
다음 데이터 구조는 앞의 표에서 사용됩니다.
MBIM_MS_CONTEXT_ROAMING_CONTROL 컨텍스트별 로밍 정책을 지정합니다. OS는 로밍 중에 지정된 컨텍스트를 사용할 수 있는지 여부를 지정할 수 있습니다. 로밍 상태가 지정된 조건을 충족하지 않는 경우 모뎀은 OS 개입 없이 컨텍스트를 자체 활성화해서는 안 됩니다. 모뎀이 파트너를 지원하지 않는 경우 모든 파트너 구성을 가정과 동등한 것으로 처리해야 합니다.
| Type | 값 | 설명 |
|---|---|---|
| MbimMsContextRoamingControlHomeOnly | 0 | 컨텍스트가 홈 네트워크에서만 사용할 수 있는지 여부를 나타냅니다. |
| MbimMsContextRoamingControlPartnerOnly | 1 | 컨텍스트가 파트너 로밍 네트워크에서만 사용할 수 있는지 여부를 나타냅니다. |
| MbimMsContextRoamingControlNonPartnerOnly | 2 | 컨텍스트가 비 파트너 로밍 네트워크에서만 사용할 수 있는지 여부를 나타냅니다. |
| MbimMsContextRoamingControlHomeAndPartner | 3 | 컨텍스트를 가정 및 파트너 로밍 네트워크에서 사용할 수 있는지 여부를 나타냅니다. |
| MbimMsContextRoamingControlHomeAndNonPartner | 4 | 컨텍스트를 홈 및 비 파트너 로밍 네트워크에서 사용할 수 있는지 여부를 나타냅니다. |
| MbimMsContextRoamingControlPartnerAndNonPartner | 5 | 컨텍스트를 파트너 및 비 파트너 로밍 네트워크에서 사용할 수 있는지 여부를 나타냅니다. |
| MbimMsContextRoamingControlAllowAll | 6 | 컨텍스트를 로밍 조건에서 사용할 수 있는지 여부를 나타냅니다. |
향후 플랫폼에서 Wi-Fi 오프로드가 지원될 때 컨텍스트가 셀룰러 또는 iWLAN에 사용되는지 여부를 지정할 수 있도록 MBIM_MS_CONTEXT_MEDIA_TYPE 추가되었습니다. 예를 들어 컨텍스트가 셀룰러로 설정되고 모뎀이 현재 Wi-Fi 오프로드인 경우 해당 컨텍스트를 사용하여 연결을 시작해서는 안 됩니다.
| Type | 값 | 설명 |
|---|---|---|
| MbimMsContextMediaTypeCellularOnly | 0 | 셀룰러를 통해 등록할 때만 컨텍스트를 사용할 수 있는지 여부를 나타냅니다. |
| MbimMsContextMediaTypeWifiOnly | 1 | iWLAN(Wi-Fi 오프로드)을 통해 등록할 때만 컨텍스트를 사용할 수 있는지 여부를 나타냅니다. |
| MbimMsContextMediaTypeAll | 2 | 셀룰러 또는 Wi-Fi를 통해 등록할 때 컨텍스트를 사용할 수 있는지 여부를 나타냅니다. |
MBIM_MS_CONTEXT_ENABLE 컨텍스트를 사용할지 여부를 지정합니다.
| Type | 값 | 설명 |
|---|---|---|
| MbimMsContextDisabled | 0 | 프로비전된 컨텍스트를 사용할 수 없습니다. 모뎀은 OS 및 자체에서 이 컨텍스트에서 활성화를 사용하도록 설정해서는 안 됩니다. |
| MbimMsContextEnabled | 1 | 프로비저닝된 컨텍스트를 사용할 수 있습니다. 다른 조건이 충족되면 컨텍스트를 사용하도록 설정할 수 있습니다. 예를 들어 로밍이 허용되지 않는 경우 로밍 중에 컨텍스트를 사용하도록 설정하면 안 됩니다. |
모뎀 컨텍스트가 만들어진 방법에 대한 OS 가시성을 제공하기 위해 MBIM_MS_CONTEXT_SOURCE 추가되었습니다. 이렇게 하면 팩터리 재설정과 같은 다양한 상황에서 OS가 올바르게 동작할 수 있으므로 다양한 연산자 요구 사항에 따라 유지되어야 하는 내용과 기본 상태로 반환해야 하는 사항을 알 수 있습니다.
| Type | 값 | 설명 |
|---|---|---|
| MbimMsContextSource관리 | 0 | 컨텍스트는 OS에서 엔터프라이즈 IT 관리자에 의해 만들어졌습니다. |
| MbimMsContextSourceUser | 1 | 컨텍스트는 OS 설정을 통해 사용자가 만들었습니다. |
| MbimMsContextSourceOperator | 2 | 컨텍스트는 OMA-DM 또는 다른 채널을 통해 연산자에 의해 만들어졌습니다. |
| MbimMsContextSourceModem | 3 | 컨텍스트는 모뎀 펌웨어에 포함된 IHV 또는 OEM에 의해 만들어졌습니다. |
| MbimMsContextSourceDevice | 4 | 컨텍스트는 OS APN 데이터베이스에 의해 만들어졌습니다. |
MBIM_MS_CONTEXT_OPERATIONS OS가 모뎀에서 컨텍스트를 구성하기 위해 수행할 수 있는 작업을 지정합니다.
| Type | 값 | 설명 |
|---|---|---|
| MbimMsContextOperationDefault | 0 | 모뎀에서 기존 컨텍스트 추가 또는 바꾸기를 포함한 기본 작업입니다. |
| MbimMsContextOperationDelete | 1 | 삭제 작업을 수행하려면 모뎀이 모뎀에서 기존 컨텍스트를 삭제해야 합니다. |
| MbimMsContextOperationRestoreFactory | 2 | 현재 삽입된 SIM의 공급자 ID에 대해 미리 구성된 팩터리 컨텍스트를 복원합니다. OS에서 대체하거나 만든 모든 컨텍스트를 제거하고 바꿔야 합니다. 현재 삽입된 SIM 공급자 ID에 대해 미리 구성된 기본 OS 컨텍스트가 없는 경우 모뎀의 프로비전된 컨텍스트를 제거해야 합니다. |
MBIM 1.0의 원래 MBIM_CONTEXT_TYPES 여전히 유효합니다. Microsoft는 MBIM 1.0이 정의된 이후 더 많은 유형의 컨텍스트가 도입됨에 따라 컨텍스트 형식을 추가하고 있습니다. 다음 표에서는 도입되는 새 형식을 정의합니다. IHV 및 OEM은 OS에서 자체 용도로 인식할 수 없는 다른 고유한 UUID 값을 사용하여 다른 독점 컨텍스트 형식을 정의할 수 있습니다.
| Type | 값 | 설명 |
|---|---|---|
| MBIMMsContextType관리 | 5f7e4c2e-e80b-40a9-a239-f0abcfd11f4b | 컨텍스트는 디바이스 관리와 같은 관리 용도로 사용됩니다. |
| MBIMMSContextTypeApp | 74d88a3d-dfbd-4799-9a8c-7310a37bb2ee | 컨텍스트는 통신사에서 허용 목록에 포함되는 특정 애플리케이션에 사용됩니다. |
| MBIMMsContextTypeXcap | 50d378a7-baa5-4a50-b872-3fe5bb463411 | 컨텍스트는 IMS 서비스의 XCAP 프로비전에 사용됩니다. |
| MBIMMsContextTypeTethering | 5e4e0601-48dc-4e2b-acb8-08b4016bbaac | 컨텍스트는 모바일 핫스팟 테더링에 사용됩니다. |
| MBIMMsContextTypeEmergencyCalling | 5f41adb8-204e-4d31-9da8-b3c970e360f2 | 컨텍스트는 IMS 긴급 통화에 사용됩니다. |
응답
다음 MBIM_MS_PROVISIONED_CONTEXT_INFO_V2 구조체는 InformationBuffer에서 사용해야 합니다.
| Offset | 크기 | 필드 | 형식 | 설명 |
|---|---|---|---|---|
| 0 | 4 | ElementCount(EC) | UINT32 | DataBuffer에서 이어지는 MBIM_MS_CONTEXT_V2 구조의 수입니다. |
| 4 | 8 * EC | MsProvisionedContextV2RefList | OL_PAIR_LIST | 쌍의 첫 번째 요소는 이 MBIM_MS_PROVISIONED_CONTEXTS_INFO_V2 구조체의 시작 부분(오프셋 0)에서 MBIM_MS_CONTEXT_V2 구조로 계산된 4바이트 오프셋(바이트)입니다(자세한 내용은 MBIM_MS_CONTEXT_V2 테이블 참조). 쌍의 두 번째 요소는 해당 MBIM_MS_CONTEXT_V2 구조체에 대한 포인터의 4 바이트 크기입니다. |
| 4 + 8 * EC | DataBuffer | DATABUFFER | MBIM_MS_CONTEXT_V2 구조체의 배열입니다. |
앞의 표에 사용된 MBIM_MS_CONTEXT_V2 지정된 컨텍스트에 대한 정보를 제공합니다.
| Offset | 크기 | 필드 | 형식 | 설명 |
|---|---|---|---|---|
| 0 | 4 | ContextId | UINT32 | 이 컨텍스트의 고유 ID입니다. |
| 4 | 16 | ContextType | MBIM_CONTEXT_TYPES | 표시되는 컨텍스트의 형식을 지정합니다. 예를 들어 인터넷 연결, VPN(회사 네트워크에 대한 연결) 또는 VOIP(Voice-over-IP)가 있습니다. 디바이스는 비어 있거나 프로비전되지 않은 컨텍스트에 대해 MBIMContextTypeNone을 지정해야 합니다. 자세한 내용은 MBIM_CONTEXT_TYPES 테이블을 참조하세요. |
| 20 | 4 | IPType | MBIM_CONTEXT_IP_TYPES | 자세한 내용은 MBIM_CONTEXT_IP_TYPES 테이블을 참조하세요. |
| 24 | 4 | Enable | MBIM_MS_CONTEXT_ENABLE | 모뎀에서 컨텍스트를 사용할 수 있는지 여부를 지정합니다. MbimMsContextDisabled로 설정된 경우 컨텍스트와 일치하는 모든 OS 연결 요청은 네트워크에 신호를 표시하지 않고 실패해야 합니다. 자세한 내용은 MBIM_MS_CONTEXT_ENABLE 표를 참조하세요. |
| 28 | 4 | 로밍 | MBIM_MS_CONTEXT_ROAMING_CONTROL | 이 컨텍스트에 대해 로밍이 허용되는지 여부를 지정합니다. 자세한 내용은 MBIM_MS_CONTEXT_ROAMING_CONTROL 테이블을 참조하세요. |
| 32 | 4 | MediaType | MBIM_MS_CONTEXT_MEDIA_TYPE | 컨텍스트가 사용되는 미디어 전송 유형을 지정합니다. 자세한 내용은 MBIM_MS_CONTEXT_MEDIA_TYPE 테이블을 참조하세요. |
| 36 | 4 | Source | MBIM_MS_CONTEXT_SOURCE | 컨텍스트의 생성 원본을 지정합니다. 자세한 내용은 MBIM_MS_CONTEXT_SOURCE 테이블을 참조하세요. |
| 40 | 4 | AccessStringOffset | OFFSET | 네트워크에 액세스하기 위해 데이터 버퍼의 오프셋을 문자열인 AccessString으로 오프셋합니다. GSM 기반 네트워크의 경우 "data.thephone-company.com"과 같은 APN(액세스 지점 이름) 문자열입니다. CDMA 기반 네트워크의 경우 "#777"과 같은 특수 다이얼 코드 또는 "foo@thephone-company.com"와 같은 NAI(네트워크 액세스 식별자)일 수 있습니다. 이 멤버는 NULL일 수 있으며 네트워크에서 기본 APN을 할당하도록 요청할 수 있습니다. 참고: 모든 네트워크가 이 NULL APN 규칙을 지원하지 않으므로 잘못된 APN으로 인한 연결 실패가 가능한 결과입니다. 문자열의 크기는 100자를 초과하면 안 됩니다. |
| 44 | 4 | AccessStringSize | SIZE(0..200) | AccessString에 사용되는 크기입니다. |
| 48 | 4 | UserNameOffset | OFFSET | 이 구조체의 시작 부분에서 인증할 사용자 이름을 나타내는 문자열 UserName으로 계산된 바이트 단위의 오프셋입니다. 이 멤버는 NULL일 수 있습니다. |
| 52 | 4 | UserNameSize | SIZE(0..510) | UserName에 사용되는 크기입니다. |
| 56 | 4 | PasswordOffset | OFFSET | 이 구조의 시작 부분에서 사용자 이름을 나타내는 문자열 암호로 계산된 바이트 단위의 오프셋입니다. 이 멤버는 NULL일 수 있습니다. |
| 60 | 4 | PasswordSize | SIZE(0..510) | 암호에 사용되는 크기입니다. |
| 64 | 4 | 압축 | MBIM_COMPRESSION | 헤더 및 데이터에 대한 데이터 연결에 사용할 압축을 지정합니다. 이 멤버는 GSM 기반 디바이스에만 적용됩니다. 호스트는 CDMA 기반 디바이스에 대해 이 멤버를 MBIMCompressionNone으로 설정합니다. 자세한 내용은 MBIM_COMPRESSION 테이블을 참조하세요. |
| 68 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | PDP 활성화에 사용할 인증 유형입니다. 자세한 내용은 MBIM_AUTH_PROTOCOL 테이블을 참조하세요. |
| 72 | DataBuffer | DATABUFFER | AccessString, UserName 및 Password를 포함하는 데이터 버퍼입니다. |
알림
자세한 내용은 MBIM_MS_PROVISIONED_CONTEXT_V2 표를 참조하세요.
상태 코드
쿼리 및 설정 작업의 경우:
| 상태 코드 | 설명 |
|---|---|
| MBIM_STATUS_READ_FAILURE | 디바이스가 프로비전된 컨텍스트를 검색할 수 없어 작업이 실패했습니다. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | 디바이스가 작업을 지원하지 않으므로 작업이 실패했습니다. |
설정 작업의 경우에만 다음을 수행합니다.
| 상태 코드 | 설명 |
|---|---|
| MBIM_STATUS_INVALID_PARAMETERS | 잘못된 매개 변수로 인해 작업이 실패했습니다. |
| MBIM_STATUS_WRITE_FAILURE | 업데이트 요청이 실패하여 작업이 실패했습니다. |
프로비전된 컨텍스트를 사용하여 디바이스 초기화
프로비전된 컨텍스트를 사용하여 비 SIM 잠금 GPRS 디바이스 초기화
다음 다이어그램은 GSM 기반 MB 디바이스에 대한 최적의 사용자 환경을 나타냅니다. 기본 제공 환경에는 사용자 구성이 필요하지 않습니다. 디바이스가 등록할 네트워크를 자동으로 선택하도록 구성된 것으로 가정합니다. 굵게 표시된 레이블은 OID 식별자 또는 트랜잭션 흐름 제어를 나타냅니다. 일반 텍스트의 레이블은 OID 구조 내의 중요한 플래그를 나타냅니다.
비 SIM 잠금 GSM 기반 디바이스를 초기화하려면 다음 단계를 구현합니다.
MB 서비스는 디바이스의 준비 상태를 식별하기 위해 비동기(비차단) OID_WWAN_READY_INFO 쿼리 요청을 미니포트 드라이버에 보냅니다. 미니포트 드라이버는 요청을 받았다는 임시 승인(NDIS_STATUS_INDICATION_REQUIRED)으로 응답하고 나중에 요청된 정보와 함께 알림을 보냅니다.
미니포트 드라이버는 MB 서비스에 MB 디바이스의 상태가 WwanReadyStateInitialized임을 나타내는 NDIS_STATUS_WWAN_READY_INFO 알림을 보냅니다.
MB 서비스는 디바이스의 등록 상태를 식별하기 위해 비동기(비차단) OID_WWAN_REGISTER_STATE 쿼리 요청을 미니포트 드라이버에 보냅니다. 미니포트 드라이버는 요청을 받았다는 임시 승인(NDIS_STATUS_INDICATION_REQUIRED)으로 응답하고 나중에 요청된 정보와 함께 알림을 보냅니다.
미니포트 드라이버는 디바이스의 등록 모드가 WwanRegistraterModeAutomatic이고 현재 등록 상태가 WwanRegisterStateSearching임을 나타내는 NDIS_STATUS_WWAN_REGISTER_STATE 알림을 MB 서비스에 보냅니다.
나중에 디바이스가 네트워크 공급자에 등록되면 미니포트 드라이버는 디바이스의 현재 등록 상태가 WwanRegisterStateHome임을 나타내는 원치 않는 NDIS_STATUS_WWAN_REGISTER_STATE 알림을 MB 서비스에 보냅니다.
디바이스가 패킷 서비스를 연결하려고 시도합니다. 패킷 서비스 상태가 연결됨으로 변경되면 미니포트 드라이버는 패킷 서비스가 연결되고 현재 데이터 클래스가 WWAN_DATA_CLASS_GPRS 것을 나타내는 원치 않는 NDIS_STATUS_WWAN_PACKET_SERVICE 알림을 MB 서비스에 보냅니다.
MB 서비스는 비동기(비차단) OID_WWAN_HOME_PROVIDER 쿼리 요청을 미니포트 드라이버에 보내 홈 공급자 정보를 검색합니다. 미니포트 드라이버는 요청을 받은 임시 승인(NDIS_STATUS_INDICATION_REQUIRED)으로 응답하고 나중에 요청된 정보와 함께 알림을 보냅니다.
미니포트 드라이버는 홈 공급자 세부 정보를 나타내는 MB 서비스에 NDIS_STATUS_WWAN_HOME_PROVIDER 알림을 보냅니다.
MB 서비스는 비동기(비차단) OID_WWAN_PROVISIONED_CONTEXTS 쿼리 요청을 미니포트 드라이버에 보내 프로비전된 컨텍스트 목록을 검색합니다. 미니포트 드라이버는 요청을 받았다는 임시 승인(NDIS_STATUS_INDICATION_REQUIRED)으로 응답하고 나중에 요청된 정보와 함께 알림을 보냅니다.
미니포트 드라이버는 WWAN_CONTEXT 구조 목록이 포함된 MB 서비스에 NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS 알림을 보냅니다.
MB 서비스는 PDP(패킷 데이터 프로토콜) 컨텍스트를 활성화하기 위해 미니포트 드라이버에 비동기(비차단) OID_WWAN_CONNECT 설정 요청을 보냅니다. 미니포트 드라이버는 요청을 받았다는 임시 승인(NDIS_STATUS_INDICATION_REQUIRED)으로 응답하고 나중에 요청된 정보와 함께 알림을 보냅니다.
미니포트 드라이버는 PDP 컨텍스트가 활성화되었음을 나타내는 NDIS_STATUS_WWAN_CONTEXT_STATE 알림을 MB 서비스에 보냅니다.
미니포트 드라이버는 미디어 연결 상태가 Media커넥트State커넥트임을 나타내는 NDIS_STATUS_LINK_STATE 알림을 보냅니다.
프로비전된 컨텍스트를 사용하여 CDMA 패킷 디바이스 초기화
다음 다이어그램에서는 CDMA 기반 디바이스에 대한 최적의 사용자 환경을 보여 줍니다. 기본 제공 환경에는 사용자 구성이 필요하지 않습니다. 이 시나리오에서는 CDMA 기반 계정이 활성화되지 않았다고 가정합니다. GSM 기반 디바이스와 달리 CDMA 기반 디바이스는 활성화가 완료된 후 네트워크 등록을 자동으로 시작합니다. 굵게 표시된 레이블은 OID 식별자 또는 트랜잭션 흐름 제어입니다. 일반 텍스트의 레이블은 OID 구조 내의 중요한 플래그입니다.
프로비전된 컨텍스트를 사용하여 CDMA 기반 패킷 디바이스를 초기화하려면 다음 단계를 구현합니다.
MB 서비스는 비동기(비차단) OID_WWAN_READY_INFO 미니포트 드라이버에 보냅니다. 미니포트 드라이버는 요청을 받았으며 나중에 요청된 정보와 함께 알림을 보낼 것이라는 임시 승인(NDIS_STATUS_INDICATION_REQUIRED)으로 응답합니다.
미니포트 드라이버는 NDIS_STATUS_WWAN_FAILURE MB 서비스로 보냅니다.
MB 서비스는 비동기(비차단) OID_WWAN_SERVICE_ACTIVATION 미니포트 드라이버에 보냅니다. 미니포트 드라이버는 요청을 받았으며 나중에 요청된 정보와 함께 알림을 보낼 것이라는 임시 승인(NDIS_STATUS_INDICATION_REQUIRED)으로 응답합니다.
미니포트 드라이버는 NDIS_STATUS_WWAN_SUCCESS MB 서비스로 보냅니다.
미니포트 드라이버는 NDIS_STATUS_WWAN_REGISTER_STATE MB 서비스로 보냅니다.
미니포트 드라이버는 NDIS_STATUS_WWAN_REGISTER_STATE MB 서비스로 보냅니다.
미니포트 드라이버는 NDIS_STATUS_WWAN_PACKET_SERVICE MB 서비스로 보냅니다.
MB 서비스는 비동기(비차단) OID_WWAN_HOME_PROVIDER 미니포트 드라이버로 보냅니다. 미니포트 드라이버는 요청을 받았으며 나중에 요청된 정보와 함께 알림을 보낼 것이라는 임시 승인(NDIS_STATUS_INDICATION_REQUIRED)으로 응답합니다.
미니포트 드라이버는 NDIS_STATUS_WWAN_SUCCESS MB 서비스로 보냅니다.
MB 서비스는 비동기(비차단) OID_WWAN_PROVISIONED_CONTEXTS 미니포트 드라이버로 보냅니다. 미니포트 드라이버는 요청을 받았으며 나중에 요청된 정보와 함께 알림을 보낼 것이라는 임시 승인(NDIS_STATUS_INDICATION_REQUIRED)으로 응답합니다.
미니포트 드라이버는 NDIS_STATUS_WWAN_SUCCESS MB 서비스로 보냅니다.
MB 서비스는 비동기(비차단) OID_WWAN_PROVISIONED_CONTEXTS 미니포트 드라이버로 보냅니다. 미니포트 드라이버는 요청을 받았다는 임시 승인(NDIS_STATUS_INDICATION_REQUIRED)으로 응답하고 나중에 요청된 정보와 함께 알림을 보냅니다.
미니포트 드라이버는 NDIS_STATUS_WWAN_SUCCESS MB 서비스로 보냅니다.
미니포트 드라이버는 NDIS_STATUS_LINK_STATE MB 서비스로 보냅니다.