NDIS_STATUS_WWAN_REGISTER_STATE

  • 아티클

미니포트 드라이버는 NDIS_STATUS_WWAN_REGISTER_STATE 알림을 사용하여 MB 디바이스의 등록 상태에 대한 변경 내용을 MB 서비스에 전달합니다.

미니포트 드라이버는 이 알림을 통해 원치 않는 이벤트를 보낼 수도 있습니다.

이 알림은 NDIS_WWAN_REGISTRATION_STATE 구조를 사용합니다.

설명

디바이스의 등록 상태가 변경되면 미니포트 드라이버는 MB 서비스가 사용자에게 올바른 상태를 반영할 수 있도록 적절한 표시를 보내야 합니다.

여러 가지 이유로 인해 등록 상태가 변경됩니다. WwanRegisterStateSearching에서 WwanRegisterStateHome으로의 일시적인 상태 전환과 같은 OID_WWAN_REGISTER_STATE 대한 MB 서비스의 설정된 요청에서 직접 발생할 수 있습니다. 자동 공급자 선택 시 미니포트 드라이버의 자동 작업으로 인해 발생할 수도 있습니다. 마지막으로 네트워크 가용성 변경으로 인해 발생할 수 있습니다. 예를 들어 네트워크 적용 범위를 잃으면 WwanRegisterStateHome 에서 WwanRegisterStateDeregistered로 전환될 수 있습니다.

MB 서비스 OID_WWAN_REGISTER_STATE 요청으로 인한 변경 사항을 제외하고 미니포트 드라이버는 기본 원인에 관계없이 등록 상태가 변경될 때마다 MB 서비스에 알려야 합니다.

CDMA 디바이스는 MB 서비스 시작 등록 및 등록 취소를 지원하지 않습니다. 그러나 통신 사업자 네트워크의 가용성 또는 비가용성을 기반으로 디바이스가 시작한 레지스터 상태 변경 알림을 MB 서비스로 보내야 합니다. CDMA 디바이스는 자동 등록을 수행해야 합니다.

현재 등록 모드(자동 또는 수동)에 관계없이 전원 켜기 시 자동 등록을 수행하는 디바이스의 경우 미니포트 드라이버는 등록 성공 시 등록 상태 알림을 보내야 합니다.

수동 등록의 경우 MB 서비스는 Miniport 드라이버가 ReadyState 가 WwanReadyStateInitialized임을 표시한 후에만 등록을 시작합니다.

미니포트 드라이버는 설정 요청에 응답하는 동안 다음 지침을 사용해야 합니다.

  • 드라이버는 설정된 요청에 대해 일시적인 상태로 응답해서는 안 됩니다. 등록의 일시적인 상태는 WwanRegisterStateSearching입니다.

  • RegisterAction이 WwanRegisterActionManual로 설정된 경우 미니포트 드라이버가 요청을 받을 때 공급자가 표시되지 않으면 미니포트 드라이버는 오류 코드 WWAN_STATUS_PROVIDER_NOT_VISIBLE 반환합니다. 수동 모드 설정 실패로 인해 디바이스가 자동 등록으로 전환해서는 안 됩니다. 디바이스가 이전에 다른 네트워크에 수동으로 등록하도록 설정된 경우 이 요청은 요청에 지정된 네트워크에 등록하도록 디바이스를 변경해야 합니다. 요청에 대한 응답으로 RegisterState 의 값을 WwanRegisterStateDeregistered로 설정해야 합니다.

  • RegisterAction이 WwanRegisterActionManual로 설정된 경우 미니포트 드라이버가 요청된 동일한 네트워크에 이미 등록된 경우 WWAN_STATUS_SUCCESS 응답해야 합니다.

  • 드라이버는 집합 OID_WWAN_REGISTER 요청에서 요청된 데이터 클래스에 등록하려고 시도해야 합니다. 미니포트 드라이버가 요청된 데이터 클래스에 등록할 수 없는 경우 최상의 데이터 클래스에 등록해야 합니다. 이는 디바이스가 다른 데이터 클래스와 함께 공급자(자동 및 수동 등록 모드)에 이미 등록된 경우에도 적용됩니다. 데이터 클래스가 변경되면 NDIS_STATUS_WWAN_PACKET_SERVICE 알림도 발생합니다.

  • RegisterAction이 WwanRegisterActionManual로 설정되고 라디오가 OFF인 경우 미니포트 드라이버는 디바이스를 수동 등록 모드로 프로그래밍하고 트랜잭션 알림으로 요청을 완료해야 합니다. RegisterState는 WwanRegisterStateDeregistered로 설정해야 합니다. 라디오가 ON 상태로 변경되고 이벤트 알림을 보내야 하는 경우 디바이스에서 수동 등록을 시도해야 합니다.

  • RegisterAction이 WwanRegisterActionAutomatic으로 설정되고 라디오가 OFF인 경우 미니포트 드라이버는 디바이스를 자동 등록 모드로 프로그래밍해야 하며 트랜잭션 알림으로 요청을 완료해야 합니다. RegisterState는 WwanRegisterStateDeregistered로 설정해야 합니다. 라디오가 ON 상태로 이동하고 이벤트 알림을 보내야 할 때 디바이스가 자동 등록을 수행해야 합니다.

  • 긴급 상태 등록(WwanRegisterStateDenied)의 경우 uStatus를 WWAN_STATUS_SUCCESS 설정해야 하며 NDIS_STATUS_WWAN_READY_INFO 알림은 WwanEmergencyModeOn으로 설정된 EmergencyMode로 전송되어야 합니다.

  • WwanRegisterStateDeregistered 상태를 사용하는 경우 미니포트 드라이버는 다음 지침을 사용해야 합니다.

    • WwanRegisterStateDeregistered 는 미니포트 드라이버에서 라디오가 OFF이지만 RegisterAction 에 대한 요청이 완료되었음을 MB 서비스에 알리는 데 사용됩니다.

    • WwanRegisterStateDeregistered 는 네트워크 시작 등록 취소를 MB 서비스에 알리기 위해 미니포트 드라이버에서 사용됩니다.

    • WwanRegisterStateDeregistered 는 네트워크 적용 범위가 없어 네트워크 연결이 끊어지는 것을 MB 서비스에 알리기 위해 미니포트 드라이버에서 사용됩니다.

  • GSM 및 CDMA 디바이스는 PS 연결에 대한 통신 사업자의 가용성 또는 비가용성을 알리기 위해 등록 상태 알림을 보내야 합니다. MB 디바이스가 통신 사업자 네트워크의 가용성을 검색하는 경우 적절한 등록 상태(WwanRegisterStateHome, WwanRegisterStateRoaming 또는 WwanRegisterStatePartner) 중 하나를 사용하여 이벤트 알림을 보내야 합니다. 통신 사업자 네트워크 신호가 손실되면 WwanRegisterStateDeregistered 가 있는 이벤트 알림을 MB 서비스에 표시해야 합니다.

미니포트 드라이버는 다음 규칙에 따라 쿼리 결과를 반환합니다.

  • 등록 중에 디바이스가 공급자에 잠기려고 할 때 미니포트 드라이버는 RegisterState 를 WwanRegisterStateSearching으로 설정해야 합니다. ProviderName 및 RoamingText 멤버는 모두 NULL로 설정해야 합니다. 수동 등록 모드의 경우 ProviderId 를 마지막 수동 등록 집합 요청의 ProviderId로 채워야 합니다. 자동 등록 모드의 경우 ProviderId를 NULL로 설정할 수 있습니다.

  • 이는 미니포트 드라이버가 등록이 끝날 때 안정적인 상태로 이동하므로 일시적인 상태입니다(예: 성공적인 등록을 위해 WwanRegisterStateHome, WwanRegisterStatePartner 또는 WwanRegisterStateRoaming ). 또는 긴급 상태 등록 을 위해 WwanRegisterStateDenied 입니다.

  • 디바이스가 공급자에 등록되지 않은 경우 미니포트 드라이버는 WwanRegisterStateDeregistered를 반환해야 합니다. ProviderName 및 RoamingText 멤버는 모두 NULL로 설정해야 합니다. 수동 등록 모드의 경우 ProviderId 를 마지막 수동 등록 집합 요청의 ProviderId로 채워야 합니다. 자동 등록 모드의 경우 ProviderId를 NULL로 설정할 수 있습니다.

  • 디바이스가 홈 공급자에 등록된 경우 미니포트 드라이버는 RegisterState 를 WwanRegisterStateHome로 설정해야 합니다. ProviderId 멤버는 홈 공급자 ID로 설정되어야 합니다. ProviderName은 홈 공급자 네트워크의 이름으로 설정해야 합니다. RoamingText 멤버를 NULL로 설정해야 합니다.

  • 디바이스가 로밍 공급자에 등록된 경우 미니포트 드라이버는 공급자가 기본 로밍 파트너이거나 로밍 파트너에 대한 WwanRegisterStateRoaming인 경우 RegisterState를 WwanRegisterStatePartner로 설정해야 합니다. 미니포트 드라이버가 둘을 구분하지 않으면 값을 WwanRegisterStateRoaming으로 설정해야 합니다. ProviderId 멤버는 디바이스가 등록된 현재 공급자의 공급자 ID로 설정되어야 하며 ProviderName은 현재 등록된 공급자 이름으로 채워져야 합니다. RoamingText 멤버가 있는 경우 일부 공급자별 문자열 값으로 설정해야 합니다. 그렇지 않으면 NULL로 설정해야 합니다.

요구 사항

Version

Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다.

헤더

 Ndis.h

추가 정보

NDIS_WWAN_REGISTRATION_STATE

OID_WWAN_REGISTER_STATE