[.Net] 네트워크 어댑터 IP주소와 고급 속성 변경하기(예제 포함)

네트워크 어댑터 IP 주소와 고급 속성

머신 비전에서 GigE 인터페이스를 사용하기 위한 네트워크 설정은 필수입니다. 카메라 연결 및 관리를 위한 고정 IP 주소 설정은 물론이고, 원활한 데이터 스트리밍을 위한 속성 설정 및 필터 드라이버(Filter Driver) 설치는 꼭 필요하죠.

설정이 필요한 네트워크 속성은 일반적으로 다음의 네 가지가 있습니다.

• 점보 패킷(Jumbo Packet)
• 수신 버퍼(Receive Buffers)
• 전송 버퍼(Transmit Buffers)
• 인터럽트 조절 속도(Interrupt Moderation Rate)

각 네트워크 속성의 의미는 아래 링크를 참고하세요.

[GigE Interface] GigE를 사용하기 위한 준비 Part 2.

[GigE Interface] GigE를 사용하기 위한 준비 Part 2.

그래서 IP 주소를 비롯하여, 위에서 언급한 속성을 코드에서 접근하기 위해서는 어떻게 해야 하는지 본문에서 다뤄보겠습니다.

1. 네트워크 IP 주소와 서브넷 마스크 얻는 방법

시스템에 존재하는 네트워크 어댑터의 목록과 IP 주소 그리고 서브넷 마스크를 얻는 방법입니다. System.Net.NetworkInformation 네임스페이스 추가하여 간단하게 어댑터의 정보를 얻을 수 있습니다.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Net.NetworkInformation; //NetworkInformation 네임스페이스 추가

namespace ExamNetwork
{
    class Program
    {
        static void Main(string[] args)
        {
            //모든 네트워크 인터페이스 얻기
            foreach (var network in NetworkInterface.GetAllNetworkInterfaces())
            {
                //IPv4를 지원하는 네트워크 확인
                if (network.Supports(NetworkInterfaceComponent.IPv4) == true)
                {
                    //이더넷 타입 확인
                    if (network.NetworkInterfaceType == NetworkInterfaceType.Ethernet)
                    {
                        //IP 속성 얻기
                        IPInterfaceProperties properties = network.GetIPProperties();
                        //Unicast 주소가 할당된 ip 얻기
                        foreach (UnicastIPAddressInformation uniIp in network.GetIPProperties().UnicastAddresses)
                        {
                            if (uniIp.Address.AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork)
                            {
                                string ipAddress = uniIp.Address.ToString();
                                string subNetMask = uniIp.IPv4Mask.ToString();
                                Console.WriteLine("======================================");
                                Console.WriteLine($"Name: {network.Name}");
                                Console.WriteLine($"Description: {network.Description}");
                                Console.WriteLine($"Type: {network.NetworkInterfaceType}");
                                Console.WriteLine($"IP: {ipAddress}");
                                Console.WriteLine($"Subnetmask: {subNetMask}");
                            }
                        }
                    }
                }
            }

            Console.ReadLine();
        }
    }
}

코드가 너무 간단해서 그다지 설명할 것이 없습니다. 실행 결과는 다음과 같습니다.

네트워크 어댑터 기본 정보를 출력한 결과

위 예제는 아래 첨부된 파일을 참고하세요.

ExamNetwork_1.zip

0.00MB

2. 네트워크의 IP 주소와 서브넷 마스크 설정하는 방법

위 방법으로 IP주소를 설정할 수 있으면 좋겠지만 설정 기능을 지원하지 않습니다. 그래서 IP 주소를 설정하기 위해서는 다른 방법을 사용해야 합니다. 바로 WMI 클래스를 사용하는 것입니다.

WMI는 Windows Management Instrumentation으로, 윈도우 운영체제의 시스템 자원을 관리할 수 있는 집합입니다. 네트워크 어댑터의 IP 주소와 서브넷 마스크를 설정하기 위해, WMI 클래스인 Win32_NetworkAdapterConfiguration를 사용하는 것입니다.

이 클래스를 사용하기 위해서는 System.Management 어셈블리를 추가해야 합니다.

프로젝트에 어셈블리 추가하기

코드는 다음과 같습니다. 참고로, 비주얼 스튜디오 또는 실행 프로그램을 관리자 권한으로 실행해야 설정이 가능합니다.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Management; //Managemnet 네임스페이스 추가

namespace ExamNetwork
{
    class Program
    {
        static void Main(string[] args)
        {
            //Win32_NetworkAdapterConfiguration class 얻기
            ManagementClass management = new ManagementClass("Win32_NetworkAdapterConfiguration");
            ManagementObjectCollection networks = management.GetInstances();

            foreach (ManagementObject network in networks)
            {
                //네트워크 어댑터의 이름과 설명 얻기
                var description = network["Description"];
                var caption = network["Caption"];
                
                //EnableStatic Method 얻기
                var objStatic = network.GetMethodParameters("EnableStatic");
                //새로 지정할 IP 주소와 서브넷 마스크 지정하기
                objStatic["IPAddress"] = new string[] { "192.168.10.1" };
                objStatic["SubnetMask"] = new string[] { "255.255.255.0" };
                //EnableStatic Method에 파라미터를 넘겨 결과 반환 받기
                var result = (uint)network.InvokeMethod("EnableStatic", objStatic, null)["returnValue"];
                if (result != 0)
                    Console.WriteLine("IP 설정 실패.");
            }

            Console.ReadLine();
        }
    }
}

설정이 필요한 네트워크 어댑터 이름을 확인한 후 IP 주소와 서브넷 마스크를 설정합니다. 그리고 그 결과를 아래와 같이 확인할 수 있습니다.

네트워크 설정 결과

위 예제는 아래 첨부된 파일을 참고하세요.

ExamNetwork_2.zip

0.00MB

특히, 이 부분은 아래 마이크로소프트 문서를 참고하면 도움이 됩니다.

https://docs.microsoft.com/ko-kr/windows/win32/cimwin32prov/win32-networkadapterconfiguration?redirectedfrom=MSDN 

Win32_NetworkAdapterConfiguration 클래스 - Win32 apps

3. 네트워크 어댑터 고급 설정 변경하기

네트워크 어댑터 고급 설정 화면

사실 이 부분을 찾기가 가장 까다로웠습니다. 점보 패킷(MTU), 수신 버퍼, 전송 버퍼 등과 같은 고급 설정을 변경하고 싶은데, 제공하는 함수를 도저히 찾을 수 없더군요. 그런데 알고 보니 아주 쉬운 방법이 있었습니다. 바로, 레지스트리를 변경하는 것이죠.

레지스트리 편집기에서 아래 경로로 이동하면, 시스템에 존재하는 네트워크 목록과 설정 값을 확인할 수 있습니다.

1. Win + R > regedit //레지스트리 편집기
2. 시작 > 레지스트리 편집기 실행

//네트워크 어댑터 목록 위치
컴퓨터\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{4d36e972-e325-11ce-bfc1-08002be10318}

레지스트리 편집기에서 네트워크 어댑터의 고급 설정 편집

네트워크 어댑터의 주요 설정 이름은 다음과 같습니다.

항목	이름
Jumbo Packet(점보 패킷)	*JumboPacket
Receive Buffers(수신 버퍼)	*ReceiveBuffers
Transmit Buffers(전송 버퍼)	*TransmitBuffers
Interrupt Moderation(인터럽트 조절)	*InterruptModeration
Interrupt Moderation Rate(인터럽트 조절 속도)	ITR

즉, 설정이 필요한 네트워크 어댑터를 찾아서 해당 위치의 키(Key) 값(Value)을 변경하면 되는 것입니다. 아주 간단하죠? 이 방법도 비주얼 스튜디오 또는 프로그램을 관리자 권한으로 실행해야 합니다.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.Win32; //Win32 네임스페이스 추가

namespace ExamNetwork
{
    class Program
    {
        static void Main(string[] args)
        {
            string network_registry = @"SYSTEM\CurrentControlSet\Control\Class\{4d36e972-e325-11ce-bfc1-08002be10318}";
            //레지스트리 열기
            RegistryKey regNetwork = Registry.LocalMachine.OpenSubKey(network_registry, false);

            //하위 키 이름 얻기
            var adapters = regNetwork.GetSubKeyNames();
            foreach (var adapter in adapters)
            {
                //어댑터의 레지스트리 얻기
                RegistryKey regAdapter = Registry.LocalMachine.OpenSubKey(network_registry + "\\" + adapter, true);

                //어댑터의 이름 얻기
                string deviceInstanceID = regAdapter.GetValue("DriverDesc").ToString();
                //점보 패킷 값 읽기
                var value = Convert.ToInt32(regAdapter.GetValue("*JumboPacket"));
                //점보 패킷 값 쓰기
                regAdapter.SetValue("*JumboPacket", "9014", RegistryValueKind.String);
            }

            Console.ReadLine();
        }
    }
}

위 예제 코드는 점보 패킷을 확인하고, 값을 9014로 설정하는 방법을 보여줍니다. 다른 설정 값도 위와 같이 적용하면 설정 값 변경이 가능합니다.

점보 패킷이 변경된 모습

위 예제는 아래 첨부된 파일을 참고하세요.

ExamNetwork_3.zip

0.00MB

정리

위에서 보여준 세 가지 방법을 조합하면 네트워크 목록을 확인하고, IP 주소와 고급 설정을 원하는 대로 변경할 수 있는 동작을 구현할 수 있습니다.