NdisConvertStringToAtmAddress

VOID NdisConvertStringToAtmAddress( OUT PNDIS_STATUS Status, IN PNDIS_STRING String, OUT PATM_ADDRESS AtmAddress );

NdisConvertStringToAtmAddress함수는 ATM어드레스를 포함하는 유니코드 스트링을 연결지향 클라이언트가 콜 파라미터들의 설정에 포함할수 있는 ATM_ADDRESS구조체로 전환한다.

매개변수

Status

이 함수가 변환에대한 상태를 리턴하는것에대한 호출자 할당 변수를 가리킨다. 가능한 리턴값은 다음과 같다.:

NDIS_STATUS_SUCCESS

변환이 성공이다.

NDIS_STATUS_INVALID_LENGTH

스트링내의 ATM어드레스가 올바른 길이가 아니다.

NDIS_STATUS_RESOURCES

NDIS는 변환을 하기위해 필요한 리소스들을 할당할수 없다.

NDIS_STATUS_FAILURE

이 스트링은 적당한 ATM어드레스로 변환될수없다.

String

변환될 ATM어드레스를 지정하는 호출자 제공 유니코드 스트링의포인터.

AtmAddress

이 루틴이 ATM_ADDRESS구조체로써 정형화된 ATM어드레스를 리턴하는 호출자 할당 버퍼의 포인터. 다음과 같이 정의된다.:

typedef struct _ATM_ADDRESS {

    ATM_ADDRESSTYPE  AddressType;

    ULONG            NumberOfDigits;

    UCHAR            Address[ATM_ADDRESS_LENGTH];

} ATM_ADDRESS, *PATM_ADDRESS;

이 구조체의 멤버는 다음 데이타를 포함한다.

AddressType

ATM 어드레스의 포맷을 지정한다. ATM_NSAP의 값은 ATM 마지막 단 어드레스(NSAP형식)를 지정한다. ATM_E164의 값은 E.164(전화통신 형식)를 지정한다.

NumberOfDigits

ATM어드레스내의 숫자의 개수를 지정한다.

Address[ATM_ADDRESS_LENGTH]

변환된 ATM어드레스의 배열

주석

연결지향 클라이언트는 유니코드내의 ATM어드레스를 ATM_ADDRESS구조체로 변환하기위해 NdisConvertStringToAtmAddress함수를 호출한다. 일반적으로, 클라이언트는 레지스트리로부터 입력 ATM어드레스 스트링을 생성한다.

만약 변환이 성공이라면, NdisConvertStringToAtmAddress함수는 변환된 ATM어드레스를 ATM_ADDRESS구조체로써의 형식으로 연속으로 리턴한다. 변환된 ATM어드레스를 제공하는것과 더불어, ATM_ADDRESS구조체는 또한 어드레스내의 숫자의 개수와 어드레스 타입을 인디케이트 한다.

클라이언트가 순차적으로 다양한 NdisXxx함수들에게 인자들로써 넘겨주는 콜 파라미터의 설정을 생성할때 클라이언트는 변환된 ATM어드레스를 사용한다.

NdisConvertStringToAtmAddress함수의 호출자는 IRQL PASSIVE_LEVEL에서 동작한다.