NDIS_STATUS_WWAN_PIN_INFO
미니포트 드라이버는 NDIS_STATUS_WWAN_PIN_INFO 알림을 사용하여 OID 쿼리에 응답하고 OID_WWAN_PIN 요청을 설정합니다.
미니포트 드라이버는 이 알림을 사용하여 원치 않는 이벤트를 보낼 수 없습니다.
이 알림은 NDIS_WWAN_PIN_INFO 구조를 사용합니다.
설명
미니포트 드라이버는 쿼리 요청에 대한 응답으로 MB 디바이스가 현재 기대하는 PIN(개인 ID 번호)에 대한 정보를 반환해야 합니다. 미니포트 드라이버는 설정된 요청에 대한 응답으로 아래 섹션에 설명된 대로 채워진 상태 알림을 반환해야 합니다.
WwanPinOperationEnter 요청에 응답
미니포트 드라이버가 NDIS_STATUS_WWAN_PIN_INFO 알림을 사용하여 WwanPinOperationEnter 요청에 응답하는 경우 다음 절차를 구현해야 합니다.
WwanPinOperationEnter 쿼리 요청이 성공하려면 MB 디바이스에 PIN이 더 이상 필요하지 않은 경우 미니포트 드라이버는 uStatus를 WWAN_STATUS_SUCCESS, PinType을 WwanPinTypeNone으로 설정해야 합니다.
실패한 WwanPinOperationEnter 요청의 경우 미니포트 드라이버는 uStatus 를 WWAN_STATUS_FAILURE 설정하고 다음 세부 정보에 따라 해당 데이터를 포함해야 합니다.
PIN 사용 안 함 또는 PIN이 예상되지 않음: WwanPinOperationEnter 집합 요청의 경우 해당 PIN이 비활성화되었거나 현재 MB 디바이스에서 예상되지 않는 경우 미니포트 드라이버는 PinType을 WwanPinTypeNone으로 설정해야 합니다. 다른 모든 멤버는 무시됩니다.
PIN 지원되지 않음: 지정된 PIN이 MB 디바이스에서 지원되지 않는 경우 미니포트 드라이버는 uStatus 를 WWAN_STATUS_NO_DEVICE_SUPPORT 설정해야 합니다.
PIN 재심: 이 모드에서는 이 특정 유형의 PIN에 대해 AttemptsRemaining 값이 여전히 0이 아니기 때문에 MB 디바이스에 PIN을 다시 입력해야 합니다. 미니포트 드라이버는 NDIS_WWAN_SET_PIN PinType 과 동일한 값으로 PinType 을 설정해야 합니다.
PIN 차단: AttemptsRemaining 이 0이면 PIN이 차단됩니다. PIN 차단 해제 작업을 사용할 수 없는 경우 미니포트 드라이버는 uStatus 를 WWAN_STATUS_FAILURE, PinType 을 WwanPinTypeNone으로 설정해야 합니다. 다른 모든 멤버는 무시됩니다.
참고 MB 디바이스가 PIN 차단 해제 작업을 지원하는 경우 미니포트 드라이버는 PIN 차단 해제 단계에 따라 요청에 응답해야 합니다.
PIN 차단 해제: AttemptsRemaining 이 0이면 PIN이 차단됩니다. PIN 차단을 해제하기 위해 MB 디바이스는 해당하는 경우 해당 PIN PUK(잠금 해제 키)를 요청할 수 있습니다. 이 경우 미니포트 드라이버는 관련 세부 정보가 포함된 해당 WwanPinTypeXxxPUK로 PinType을 설정해야 합니다.
차단된 PUK: 실패한 평가판 수가 WwanPinTypeXxxPUK를 입력하기 위한 미리 설정된 값을 초과하면 PUK가 차단됩니다. 미니포트 드라이버는 uStatus 를 WWAN_STATUS_FAILURE , PinType 을 WwanPinTypeNone으로 설정하여 신호를 보내야 합니다. PUK1이 차단된 경우 미니포트 드라이버는 ReadyState 가 WwanReadyStateBadSim으로 설정된 NDIS_STATUS_WWAN_READY_INFO 보내야 합니다.
WwanPinOperationEnable, WwanPinOperationDisable 또는 WwanPinOperationChange 요청에 응답
미니포트 드라이버가 NDIS_STATUS_WWAN_PIN_INFO 알림을 사용하여 WwanPinOperationEnable, WwanPinOperationDisable 및 WwanPinOperationChange에 응답하는 경우 다음 작업을 구현해야 합니다.
요청이 성공하려면 미니포트 드라이버가 uStatus 를 WWAN_STATUS_SUCCESS 설정해야 합니다. WWAN_PIN_INFO 다른 멤버는 다음 상황을 참조하세요.
미니포트 드라이버는 PIN이 이미 요청된 상태인 경우 PIN 사용 및 PIN 사용 안 함 작업에 대해 uStatus 를 WWAN_STATUS_SUCCESS 설정해야 합니다. 미니포트 드라이버는 PinType 을 WwanPinTypeNone으로 설정해야 합니다. 다른 멤버는 무시됩니다.
PIN 모드가 사용 안 함에서 사용으로 변경되면 PIN 상태는 WwanPinStateNone이어야 합니다.
PIN1을 사용하도록 설정하면 전원이 MB 디바이스로 순환될 때 PIN 상태가 WwanPinStateEnter가 됩니다.
다른 모든 PIN의 경우 PIN 상태는 MB 디바이스별 조건에 따라 WwanPinStateNone에서 WwanPinStateEnter로 변경될 수 있습니다.
PIN 지원되지 않음: MB 디바이스에서 PIN 작업을 지원하지 않는 경우 미니포트 드라이버는 uStatus 를 WWAN_STATUS_NO_DEVICE_SUPPORT 설정해야 합니다. 예를 들어 PIN2를 사용하도록 설정하고 사용하지 않도록 설정하는 것은 일반적으로 MB 디바이스에서 지원되지 않으므로 위의 오류 코드를 반환해야 합니다. 다른 모든 멤버는 무시됩니다.
PIN을 입력해야 합니다. PIN 작업에 PIN을 입력해야 하는 경우 미니포트 드라이버는 uStatus 를 WWAN_STATUS_PIN_REQUIRED, PinType 을 WwanPinTypeXxx로 설정해야 합니다. 다른 멤버는 무시됩니다.
PIN 변경 작업: MB 디바이스가 활성화된 상태일 때만 PIN 값 변경을 제한하는 경우 사용 안 함 상태의 변경 요청은 WWAN_STATUS_PIN_DISABLED 함께 반환되어야 합니다.
PIN 재심: 실패 시 미니포트 드라이버는 uStatus 를 WWAN_STATUS_FAILURE 설정하고 PinType 을 NDIS_WWAN_SET_PIN 지정된 값과 동일한 값으로 설정해야 합니다. AttemptsRemaining을 제외하고 다른 멤버는 무시됩니다. 잘못된 PIN을 입력할 때 발생할 수 있습니다.
PIN 차단: AttemptsRemaining 수가 0이면 PIN이 차단됩니다. PIN 차단 해제 작업을 사용할 수 없는 경우 미니포트 드라이버는 uStatus 를 WWAN_STATUS_FAILURE, PinType 을 WwanPinTypeNone으로 설정해야 합니다. AttemptsRemaining은 0으로 설정해야 하며 다른 모든 멤버는 무시됩니다.
참고 MB 디바이스가 PIN 차단 해제 작업을 지원하는 경우 미니포트 드라이버는 PIN 차단 해제 단계에 따라 요청에 응답해야 합니다.
PIN 차단 해제: AttemptsRemaining 이 0이면 PIN이 차단됩니다. PIN 차단을 해제하기 위해 MB 디바이스는 해당하는 경우 해당 PUK를 요청할 수 있습니다. 이 경우 미니포트 드라이버는 uStatus를 WWAN_STATUS_FAILURE, PinType을 해당 WwanPinTypeXxxPUK로, PinState를 WwanPinStateEnter로 설정해야 하며, AttemptsRemaining에는 유효한 PUK를 입력할 수 있는 시도 횟수가 있어야 합니다.
PIN 차단으로 인해 MB 디바이스 또는 SIM이 차단되면 미니포트 드라이버는 ReadyState 가 WwanReadyStateDeviceLocked로 설정된 이벤트 알림을 보내야 합니다.
PIN1 차단 시 활성 PDP 컨텍스트가 있는 경우 미니포트 드라이버는 PDP 컨텍스트를 비활성화하고 PDP 비활성화 및 링크 상태 변경에 대한 알림을 운영 체제에 보내야 합니다.
요구 사항
Version |
Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다. |
헤더 |
Ndis.h |