NdisReadNetworkAddress

VOID NdisReadNetworkAddress( OUT PNDIS_STATUS Status, OUT PVOID *NetworkAddress, OUT PUINT NetworkAddressLength, IN NDIS_HANDLE ConfigurationHandle );

NdisReadNetworkAddress 함수는 기계에 인스톨할 때 NIC을 위해 레지스트리내에 저장된 소프트웨어로 구성할 수 있는 네트워크 주소를 리턴한다.

매개변수

Status

이 함수는 다음과 같은 하나로 호출 상태를 리턴하는 호출자 제공 변수를 가리킨다.

NDIS_STATUS_SUCCESS

호출자는 NIC을 위해 NetworkAddress에서 리턴된 주소를 사용할 수 있다.

NDIS_STATUS_FAILURE

호출자의 레지스트리 Parameters 키에 이용할 수 있는 주소 정보가 없거나 저장된 값이 문자열이 아니다.

NerworkAddress

이 함수는 만약 호출이 성공적이라면은, 바이트 정수들의 연속으로 저장된 버퍼화된 네트워크 주소에 대한 포인터를 리턴하는 호출자 제공 변수를 가리킨다.

NetworkAddressLength

이 함수는 NetworkAddress에 리턴된 바이트 수들로 리턴한 호출자 제공 변수를 가리킨다.

ConfigurationHandle

NdisOpenConfiguration에 의해 리턴된 핸들을 지정한다.

주석

NdisReadNetworkAddress는 키워드 NetworkAdddress를 위해 주어진 ConfigurationHandle에 의해 지정된 레지스트리 Parameters 키를 찾고 이러한 문자열 타입 엔트리의 값을 연속된 바이트 정수들로 바꾸고, 내부적으로 요구된 정보를 저장한다. NDIS가 그러한 주소를 위해 할당한 저장 공간은 NIC이 메모리를 해제하는 NdisCloseConfiguration을 호출할 때까지 유효하다.

호출자는 만약 NdisReadNetworkAddress가 Status에서 NDIS_STATUS_SUCCESS로 리턴하지 못한다며은 포인터로서 NetworkAddress 변수는 사용할 수 없다.

소프트웨어로 구성할 수 있는 네트워크 주소를 지정하는 것을 지원하는 NIC을 위한 인스톨 프로그램은 레지스트리내의 HKLM\System\CurrentControlSet\Control\Class\{4d36e972...}\00xx키내에 NetworkAddress 키워드 이름을 가진 값 엔트리를 저장해야 한다.

NIC 인스톨러는 항상 16진 값의 숫자의 문자열로 레지스트리내에 NetworkAddress 엔트리의 값을 저장한다. 선택적으로, 인스톨러는 하이프에 의해 다음 값으로부터 분리하는 각 쌍으로 두쌍의 숫자들의 문자열로 그러한 주소를 저장할 수 있다. NdisReadNetworkAddress 함수는 하이프(hyphens)를 주시하고 각 그러한 쌍을 하나의 바이트로 바꾼다.

양쪽 어느쪽의 형태이든지 NdisReadNetworkAddress는 문자열로 지정된 주소를 한번에 한 문자씩 문자열이 다 사용될 때까지 동등한 정수 값으로 바꾼다.

윈도우즈 2000 레지스트리내에서, 그러한 인스톨된 주소 문자열은 Unicode 문자들을 포함한다.

NdisReadNetworkAddress의 호출자들은 IRQL PASSIVE_LEVEL에서 실행한다.