MB 운영 의미 체계

비동기 트랜잭션

MB 드라이버 모델은 NDIS 6.x에 제공된 비동기 알림 메커니즘을 사용하여 MB 서비스와 미니포트 드라이버 간의 비차단 운영 의미 체계를 가정합니다. 이 메커니즘을 사용하면 MB 서비스가 현재 작업이 완료 될 때까지 기다리지 않고 처리를 위해 미니 포트 드라이버에 OID 요청을 계속 보낼 수 있습니다.

비동기 트랜잭션은 초기 요청으로 시작하고 요청 상태 응답을 수행한 다음 최종 트랜잭션 표시로 완료되는 3방향 핸드셰이크입니다. 요청 상태 응답은 미니포트 드라이버가 요청을 수신했음을 인정한다는 측면에서 임시입니다. 후속 비동기 표시는 트랜잭션 완료를 알리는 트랜잭션입니다. 미니포트 드라이버는 트랜잭션 표시의 결과 데이터뿐만 아니라 상태 코드를 반환합니다.

비동기 집합 및 쿼리 요청

MB 서비스에서 사용되는 대부분의 집합 및 쿼리 OID 요청은 비동기적으로 처리됩니다. OID 요청 설정 및 쿼리 에 대한 자세한 내용은 NDIS_OID_REQUEST 참조하세요. MB 데이터 모델 항목의 "WWAN 관련 OID" 테이블은 비동기적으로 처리되는 ID를 식별합니다.

다음 다이어그램은 MB 서비스와 미니포트 드라이버 간의 비동기 쿼리 트랜잭션에 대한 상호 작용 시퀀스를 나타냅니다. 굵게 표시된 레이블은 OID 식별자 또는 트랜잭션 흐름 제어를 나타내며 일반 텍스트의 레이블은 OID 구조 내의 중요한 플래그를 나타냅니다.

3방향 핸드셰이크는 쿼리 및 설정 요청 모두에 대해 동일합니다.

OID_WWAN_DRIVER_CAPS 제외하면 다른 모든 MB별 OID 요청은 미니포트 드라이버와 MB 서비스 간의 정보 교환을 위한 비동기 트랜잭션 메커니즘을 따르며 다음 추가 정보를 제공합니다.

• 미니포트 드라이버는 잘못된 OID 요청과 같은 오류 조건에서 OID 요청을 즉시 실패해야 합니다.

• 미니포트 드라이버는 이벤트 알림 구조의 uStatus 멤버에 지정된 올바른 오류 코드(예: WWAN_STATUS_XXX)를 사용하여 WWAN 관련 오류 조건을 반환해야 합니다. 또한 미니포트 드라이버는 필요에 따라 uStatus 멤버를 따르는 멤버를 적절하게 채워야 합니다. 예를 들어 미니포트 드라이버는 사용 가능한 경우 NDIS_WWAN_CONTEXT_STATE 구조체의 ContextState.uNwError 멤버를 입력해야 합니다. 그러나 PIN과 관련된 OID를 처리할 때 오류가 발생하는 경우 미니포트 드라이버에는 NDIS_WWAN_PIN_INFOPinInfo.PinState 멤버에 지정할 현재 PIN 상태 정보가 반드시 있어야 하는 것은 아닙니다.

• 미니포트 드라이버는 모든 비동기 OID 요청에 대한 임시 응답으로 NDIS_STATUS_INDICATION_REQUIRED 반환해야 합니다.

• 미니포트 드라이버는 OID 요청으로 인한 디바이스 상태 변경 내용을 다른 원인과 구분할 수 있어야 합니다. 미니포트 드라이버는 OID 요청으로 인한 상태 변경에 대한 트랜잭션 알림을 보내야 하며, 다른 원인의 상태 변경에 대한 원치 않는 이벤트 알림을 보내야 합니다.

• 미니포트 드라이버는 커널 모드 메모리를 관리하지만 MB 서비스는 처음에 요청에 대한 메모리를 할당합니다. MB 서비스가 미니포트 드라이버로부터 응답을 받은 후 서비스는 OID 요청에 할당된 사용자 모드 메모리를 해제할 수 있습니다.

다음 다이어그램은 MB 서비스와 미니포트 드라이버 간의 비동기 집합 트랜잭션에 대한 상호 작용 시퀀스를 나타냅니다. 굵게 표시된 레이블은 OID 식별자 또는 트랜잭션 흐름 제어를 나타내며 일반 텍스트의 레이블은 OID 구조 내의 중요한 플래그를 나타냅니다.

비동기 응답

NDIS 6.0 사양(Windows Vista와 함께 릴리스됨)은 미니포트 드라이버가 OID 요청에 대한 미니포트 드라이버의 임시 응답에서 트랜잭션의 비동기 특성을 MB 서비스에 전달하기 위한 새로운 상태 코드인 NDIS_STATUS_INDICATION_REQUIRED 도입했습니다.

MB 인터페이스 개요에서 설명한 것처럼 MB 서비스는 MB 미니포트 드라이버가 할당한 커널 모드 메모리에 직접 액세스할 수 없습니다. 커널 모드 메모리에 저장된 실행 결과는 WMI 또는 NDIS 필터 드라이버와 같은 일부 중간자에서 복사되어 MB 서비스에 제공된 것으로 간주됩니다. 따라서 미니포트 드라이버는 트랜잭션 표시에서 NdisMIndicateStatusEx 함수 호출이 반환된 후 할당된 커널 모드 메모리를 해제할 수 있습니다.

드라이버와 MB 서비스를 최소화하는 핸드셰이크 절차는 다음 절차에 설명되어 있습니다.

MB 미니포트 드라이버 프로시저

OID 요청을 받으면 미니포트 드라이버는 다음 단계를 수행해야 합니다.

1. 커널 모드에서 메모리를 할당하여 OID 요청과 연결된 NDIS_OID_REQUEST 데이터 구조의 내용을 복사합니다.

2. 요청의 매개 변수 중에서 OID 요청 구조의 RequestId 및 RequestHandle 멤버도 복사되었는지 확인합니다. 이러한 멤버는 트랜잭션 표시의 뒷부분에서 사용됩니다.

3. 미니포트 드라이버가 요청을 비동기적으로 완료할 것임을 MB 서비스에 알리기 위해 임시 NDIS_STATUS_INDICATION_REQUIRED 상태 응답을 반환합니다.

4. 작업이 완료되면 결과를 로컬 또는 드라이버 할당 메모리에 적절하게 저장합니다.

5. NdisMIndicateStatusEx 함수를 호출하여 MB 서비스에 미해결 작업이 완료되었음을 알립니다. 미니포트 드라이버는 다음과 같이 NDIS_STATUS_INDICATION 구조체의 멤버를 채워야 합니다.

   1. StatusCode 멤버를 상태 알림 유형으로 설정합니다. 예를 들어 NDIS_STATUS_WWAN_XXX.
   2. Miniport 드라이버가 해당 OID 요청을 받았을 때 NDIS_OID_REQUEST 데이터 구조에서 수신된 RequestHandle 멤버로 DestinationHandle 멤버를 설정합니다.
   3. 미니포트 드라이버가 해당 OID 요청을 받았을 때 NDIS_OID_REQUEST 상태 구조의 RequestId 멤버와 일치하도록 RequestId 멤버를 설정합니다.
   4. StatusBuffer 및 StatusBufferSize 멤버를 각각 미니포트 드라이버 할당 메모리와 메모리 버퍼 크기를 가리키도록 설정합니다. 이 메모리 버퍼에는 완료된 작업의 결과가 포함됩니다.
   5. 작업이 성공적으로 완료되면 uStatus 멤버를 WWAN_STATUS_SUCCESS 설정합니다. 그렇지 않으면 uStatus 멤버를 적절한 WWAN_STATUS_XXX 값으로 설정하여 실패 유형을 나타냅니다.

6. 함수 호출이 반환되면 미니포트 드라이버는 OID 요청에 할당된 메모리를 해제해야 합니다.

MB 서비스 프로시저

MB 서비스는 다음 절차를 사용하여 비동기 트랜잭션을 처리합니다.

1. OID 데이터 구조에 따라 요청에 대한 버퍼 메모리를 할당합니다. 데이터 구조 멤버를 적절한 값으로 채웁니다.

2. OID 요청에 대한 OID 데이터 구조를 가리키는 InformationBuffer 멤버를 사용하여 NdisOidRequest 함수를 호출하고 미니포트 드라이버가 응답할 때까지 기다립니다.

3. 미니포트 드라이버에서 NDIS_STATUS_INDICATION_REQUIRED 임시 응답을 받으면 MB 서비스는 RequestId를 저장하고, 할당된 메모리를 해제하고, 트랜잭션을 열린 것으로 표시합니다. 이 시점에서 MB 서비스는 후속 OID 요청 및 알림을 자유롭게 처리할 수 있습니다.

4. NDIS_STATUS_WWAN_XXX StatusCode 값으로 알림을 받으면 RequestId가 열려 있는 것으로 표시된 트랜잭션과 일치하는지 여부를 검사. 일치하는 항목이 있는 경우 서비스는 트랜잭션을 닫습니다. 일치하는 항목이 없으면 알림을 원치 않는 이벤트 알림으로 처리합니다.

5. StatusBuffer 멤버에서 반환된 데이터를 처리하고 MB 서비스를 적절하게 변경합니다.

표시

미니포트 드라이버가 생성할 수 있는 두 가지 유형의 WWAN 관련 표시 가 있습니다.

• MB 디바이스의 개체 상태 변경으로 인한 이벤트 알림입니다.

• 비동기 작업의 완료를 알리는 트랜잭션 알림입니다.

두 경우 모두 미니포트 드라이버는 NdisMIndicateStatusEx 함수를 호출해야 합니다.

이벤트 알림

미니포트 드라이버가 MB 서비스에 상태 변경 이벤트로 표시를 사전에 전송한다는 점에서 이벤트 알림은 원치 않습니다. 상태 변경은 MB 서비스가 아닌 일부 엔터티의 작업으로 인해 발생합니다. MB 서비스는 미니포트 드라이버가 변경 원인을 감지할 수 있다고 가정합니다.

WWAN 관련 이벤트 알림의 경우 미니포트 드라이버는 NDIS_STATUS_INDICATION 구조체의 RequestId 멤버를 0으로 설정해야 합니다. StatusCode 멤버는 MB 디바이스에서 변경된 개체를 지정합니다. 미니포트 드라이버는 이 개체를 다음 값으로 설정할 수 있습니다.

NDIS_STATUS_WWAN_DEVICE_CAPS

NDIS_STATUS_WWAN_READY_INFO

NDIS_STATUS_WWAN_RADIO_STATE

NDIS_STATUS_WWAN_PIN_INFO

NDIS_STATUS_WWAN_PIN_LIST

NDIS_STATUS_WWAN_HOME_PROVIDER

NDIS_STATUS_WWAN_PREFERRED_PROVIDERS

NDIS_STATUS_WWAN_VISIBLE_PROVIDERS

NDIS_STATUS_WWAN_REGISTER_STATE

NDIS_STATUS_WWAN_PACKET_SERVICE

NDIS_STATUS_WWAN_SIGNAL_STATE

NDIS_STATUS_WWAN_CONTEXT_STATE

NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS

NDIS_STATUS_WWAN_SERVICE_ACTIVATION

NDIS_STATUS_WWAN_SMS_CONFIGURATION

NDIS_STATUS_WWAN_SMS_RECEIVE

NDIS_STATUS_WWAN_SMS_SEND

NDIS_STATUS_WWAN_SMS_DELETE

NDIS_STATUS_WWAN_SMS_STATUS

NDIS_STATUS_WWAN_VENDOR_SPECIFIC

MB 서비스는 NDIS에서 다른 이벤트 알림을 처리할 수도 있습니다. 이러한 MB가 아닌 이벤트 알림에는 RequestId 값을 0으로 설정해야 하는 요구 사항이 반드시 적용되는 것은 아닙니다.

트랜잭션 알림

미니포트 드라이버는 트랜잭션 알림을 사용하여 비동기 트랜잭션이 완료되었음을 MB 서비스에 알리고, MB 서비스는 트랜잭션 알림을 사용하여 열린 트랜잭션을 닫고 상태 컴퓨터를 업데이트합니다.

MB 서비스는 열려 있는 트랜잭션을 닫을 수 있도록 트랜잭션 알림을 예상합니다. MB 서비스와 비동기 트랜잭션의 미니포트 드라이버 간의 3방향 핸드셰이크를 마지막으로 교환하는 것입니다. 트랜잭션 알림에 있는 NDIS_STATUS_INDICATION RequestId 멤버의 값은 0이 아니어야 하며, 이 값은 동일한 트랜잭션의 해당 요청에서 복사됩니다.

비동기 메커니즘이 제대로 작동하려면 NDIS_STATUS_INDICATION 구조체의 RequestId 멤버를 올바르게 설정해야 합니다. MB 서비스는 RequestId 값이 모든 미해결 요청 중에서 고유하고 0이 아닌지 확인합니다. 미니포트 드라이버는 MB 서비스가 표시를 열린 트랜잭션과 상호 연결하기 위해 해당 표시에서 동일한 RequestId 값을 반환해야 합니다.

상태 표시 구조

지정된 OID 요청에 대한 비동기 응답과 원치 않는 이벤트 알림 구조체는 StatusIndication 매개 변수의 StatusBuffer 멤버가 가리키는 다음 구조체 멤버를 NdisMIndicateStatusEx에 공유합니다.

typedef struct _NDIS_WWAN_XXX {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS uStatus;
  ULONG uNwError;//Optional. Only used for network operations.
  WWAN_XXX XxxStruct;
} NDIS_WWAN_XXX, *PNDIS_WWAN_XXX;

NDIS_STATUS_INDICATION 구조체의 RequestId 멤버에서 값이 0이면 원치 않는 이벤트 알림이며 언제든지 발생할 수 있습니다.

모든 집합 또는 쿼리 OID 요청의 반환된 표시에 있는 uStatus 멤버가 WWAN_STATUS_SUCCESS 같지 않으면 연결된 NDIS_WWAN_XXX 구조체의 멤버가 유효할 필요가 없습니다.

네트워크 이벤트를 기반으로 하는 원치 않는 이벤트 알림의 경우 미니포트 드라이버는 해당하는 경우 uNwError 멤버를 적절하게 채워야 합니다.

다음 표에서는 GSM 기반 네트워크에 대한 3GPP TS 24.008 사양 에 정의된 등록, 패킷 연결 및 패킷 분리 원인 코드 오류 값을 보여 줍니다.

예를 들어 위치 영역에서 로밍이 허용되지 않으므로 네트워크에서 비활성화 컨텍스트 이벤트를 시작하는 경우 미니포트 드라이버는 3GPP TS 24.008 GSM 기반 네트워크의 원인 코드에 따라 uNwError 멤버를 13으로 설정해야 합니다.

CDMA 기반 네트워크에도 유사한 논리를 적용해야 합니다. 그러나 CDMA 기반 네트워크 오류 코드에 대한 표준은 없습니다. CDMA 기반 디바이스는 네트워크별 또는 디바이스별 오류 코드를 사용해야 합니다.

OID 요청에 대한 미니포트 드라이버의 비동기 응답의 경우 NDIS_STATUS_INDICATION 구조체의 RequestId 멤버는 set 또는 query 요청의 일부로 미니포트 드라이버에 전달된 0이 아닌 숫자입니다. 미니포트 드라이버는 uStatus 멤버를 적절하게 채워야 합니다. 예를 들어 WWAN_STATUS_SUCCESS 또는 다음 섹션에 나열된 적절한 오류 값이 있습니다. 이 외에도 미니포트 드라이버는 적절하고 사용 가능한 uNwError 멤버를 채워야 합니다.

이벤트 알림 상태

다음 표에서는 MB 미니포트 드라이버가 NDIS_WWAN_XXX 이벤트 알림 구조의 uStatus 멤버에서 지정할 수 있는 WWAN_STATUS 코드를 나열합니다.

다음 표에서는 SMS 관련 상태 값을 보여줍니다.

참고 이러한 WWAN 관련 상태 코드는 NDIS_WWAN_XXX 구조체의 uStatus 멤버에 있는 비동기 트랜잭션에만 사용됩니다.

미니포트 드라이버는 이벤트 알림을 사용하여 OID 요청을 먼저 받지 않고 MB 디바이스의 개체 상태 변경에 대해 MB 서비스에 알릴 수 있습니다. MB 서비스는 이벤트 알림을 사용하여 상태 머신만 업데이트합니다.

NDIS는 미니포트 드라이버로 전송되는 모든 요청을 직렬화하지만 미니포트 드라이버는 동일한 순서로 응답을 반환하지 않을 수 있습니다. 미니포트 드라이버에서 대기 중인 요청이 병렬로 처리될 수 있기 때문입니다. 따라서 MB 서비스는 두 요청이 서로 종속된 경우 미니포트 드라이버가 첫 번째 요청을 완료할 때까지 두 번째 요청을 보내지 않도록 합니다.

상태 변경 알림

일반적으로 미니포트 드라이버는 항상 트랜잭션 알림 또는 원치 않는 이벤트 알림을 통해 MB 디바이스의 업데이트된 상태에 대해 MB 서비스에 알려야 합니다. 다음 시나리오는 미니포트 드라이버가 업데이트된 상태 정보로 응답하지 않아야 하는 몇 가지 예외입니다. MB 서비스는 다른 작업의 완료 상태 업데이트된 상태를 확인할 수 있습니다.

1. 미니포트 드라이버는 MB 서비스가 PIN을 사용하거나 사용하지 않도록 요청했기 때문에 PIN 상태가 변경되는 경우 NDIS_STATUS_WWAN_PIN_LIST 이벤트 표시를 보낼 필요가 없습니다.

2. 미니포트 드라이버는 트랜잭션 응답에서 프로비전된 컨텍스트의 업데이트된 목록을 OID_WWAN_PROVISIONED_CONTEXT 설정 작업에 반환할 필요가 없습니다.

3. 미니포트 드라이버는 OID_WWAN_PREFERRED_PROVIDERS 설정 작업에 대한 트랜잭션 응답에서 기본 설정 공급자의 업데이트된 목록으로 응답할 필요가 없습니다. MB 서비스는 집합 작업의 초기 목록 및 성공 상태 따라 이 정보를 확인할 수 있습니다.

4. 미니포트 드라이버는 OID_WWAN_SMS_CONFIGURATION 설정 작업에 대한 현재 WWAN_SMS_CONFIGURATION 값으로 응답할 필요가 없습니다.