NDIS_WWAN_CONTEXT_STATE 구조체(ndiswwan.h)

  • 아티클

NDIS_WWAN_CONTEXT_STATE 구조는 MB 디바이스의 PDP(패킷 데이터 프로토콜) 컨텍스트 상태를 나타냅니다.

구문

typedef struct _NDIS_WWAN_CONTEXT_STATE {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_CONTEXT_STATE ContextState;
} NDIS_WWAN_CONTEXT_STATE, *PNDIS_WWAN_CONTEXT_STATE;

멤버

Header

NDIS_WWAN_CONTEXT_STATE 구조체에 대한 형식, 수정 버전 및 크기 정보가 포함된 헤더입니다. MB 서비스는 설정 작업을 위해 데이터 구조를 미니포트 드라이버로 보낼 때 다음 표에 표시된 값으로 헤더를 설정합니다 . 미니포트 드라이버는 데이터 구조를 MB 서비스로 보낼 때 동일한 값으로 헤더를 설정해야 합니다.

헤더 하위 정보 값
형식 NDIS_OBJECT_TYPE_DEFAULT
수정 버전 Windows 8 미니포트 드라이버는 이를 NDIS_WWAN_CONTEXT_STATE_REVISION_2 설정해야 합니다. Windows 7 미니포트 드라이버는 이를 NDIS_WWAN_CONTEXT_STATE_REVISION_1 설정해야 합니다.
크기 sizeof(NDIS_WWAN_CONTEXT_STATE)
 

이러한 멤버에 대한 자세한 내용은 NDIS_OBJECT_HEADER.

uStatus

컨텍스트 활성화 또는 비활성화 작업의 상태. 다음 표에서는 이 멤버에 대해 가능한 값을 보여 있습니다.

값 의미
WWAN_STATUS_SUCCESS 컨텍스트 활성화 또는 비활성화에 성공했습니다.
WWAN_STATUS_FAILURE 작업이 실패했습니다. 미니포트 드라이버는 컨텍스트가 이미 활성화된 경우 이 값을 반환할 수 있습니다.
WWAN_STATUS_PIN_REQUIRED 디바이스에 PIN이 필요하므로 작업이 실패했습니다.
WWAN_STATUS_BAD_SIM 잘못된 SIM 카드 검색되어 작업이 실패했습니다.
WWAN_STATUS_SIM_NOT_INSERTED SIM 카드 디바이스에 완전히 삽입되지 않아 작업이 실패했습니다.
WWAN_STATUS_NOT_INITIALIZED 디바이스가 초기화 중이므로 작업이 실패했습니다. 디바이스의 준비 상태가 WwanReadyStateInitialized로 변경된 후 작업을 다시 시도합니다.
 

미니포트 드라이버는 PDP 정품 인증 작업이 실패한 경우에만 다음과 같은 오류 코드를 반환할 수 있습니다(앞에서 설명한 것 외에).

값 의미
WWAN_STATUS_RADIO_POWER_OFF 라디오가 현재 꺼져 있으므로 작업이 실패했습니다. 이 오류 코드는 OID_WWAN_CONNECT 집합 요청에 대한 응답으로만 반환되어야 합니다. 라디오 상태가 꺼져 있으면 미니포트 드라이버는 WWAN_STATUS_SUCCESS OID_WWAN_CONNECT 쿼리 요청에 응답하고 현재 컨텍스트 상태를 WwanActivationStateDeactivated로 지정해야 합니다.
WWAN_STATUS_SERVICE_NOT_ACTIVATED 구독이 만료되었거나 디바이스에서 PDP 활성화를 허용하지 않아 작업이 실패했습니다.
WWAN_STATUS_PROVIDER_NOT_VISIBLE 서비스 공급자가 현재 표시되지 않아 작업이 실패했습니다.
WWAN_STATUS_MAX_ACTIVATED_CONTEXTS 활성화된 컨텍스트의 최대 수에 도달했기 때문에 작업이 실패했습니다.
WWAN_STATUS_INVALID_ACCESS_STRING 액세스 문자열이 잘못되어 작업이 실패했습니다.
WWAN_STATUS_INVALID_USER_NAME_PWD 제공된 사용자 이름 및/또는 암호가 잘못되어 작업이 실패했습니다. 네트워크별 오류 코드는 uNwError 에서 사용할 수 있습니다.
WWAN_STATUS_PACKET_SVC_DETACHED 패킷 서비스가 분리되어 작업이 실패했습니다.
WWAN_STATUS_NOT_REGISTERED 디바이스가 PDP 활성화를 수행하기 위해 등록된 상태가 아니므로 작업이 실패했습니다.
WWAN_STATUS_VOICE_CALL_IN_PROGRESS 작업이 실패했으며 음성 통화가 현재 진행 중이므로 PDP 활성화를 진행할 수 없습니다. 이 값은 음성 클래스가 WwanVoiceClassSeparateVoiceData로 설정된 디바이스에만 적용됩니다.
WWAN_STATUS_CONTEXT_NOT_ACTIVATED ConnectionId로 식별된 컨텍스트가 현재 활성화된 컨텍스트가 아니므로 작업이 실패했습니다.

ContextState

디바이스의 PDP(패킷 데이터 프로토콜) 컨텍스트 상태를 나타내는 형식이 지정된 WWAN_CONTEXT_STATE 개체입니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다.
머리글 ndiswwan.h(Ndiswwan.h 포함)

추가 정보

NDIS_OBJECT_HEADER

WWAN_CONTEXT_STATE