NdisMQueryAdapterInstanceName

NDIS_STATUS NdisMQueryAdapterInstanceName( OUT PNDIS_STRING AdapterInstanceName, IN NDIS_HANDLE MiniportAdapterHandle );

NdisMQueryAdapterInstanceName 함수는 물리 NIC 혹은 가상 어댑터의 호의적인 이름을 얻는다.

매개변수

AdapterInstanceName

카운트된 유니코드 문자열을 받는호출자 제공 변수를 가리킨다. 이 문자열은 주어진 미니포트 인스턴스를 위해서 인터페이스의 호의적인 이름을 서술한다. 이 인터페이스는 물리 NIC 혹은 가상 어댑터이다.

MiniportAdapterHandle

MiniportInitialize 함수로 전에 입력된 미니포트 어댑터의 핸들을 서술한다. 이 미니포트 어댑터는 물리 NIC 혹은 가상 어댑터를 확인한다.

리턴값

AdapterInstanceName에 문자열을 위한 메모리가 성공적으로 할당됐다면 NDIS_STATUS_SUCCESS를 리턴한다. 그렇지 않으면 NDIS_STATUS_RESOURCES를 리턴한다.

주석

미니포트 드라이버는 미니포트 드라이버가 통제하는 인터페이스의 호의적인 이름을 얻기 위해서 NdisMQueryAdapterInstanceName 함수를 사용한다. 이 인터페이스는 물리 NIC 혹은 가상 어댑터이다. 미니포트 드라이버는 MiniportAdapterHandle로 그러한 인터페이스에 대한 핸들을 서술한다. 인터페이스에 대한 핸들은 네트웍 I/O 연산에 대한 인터페이스를 설정하기 위해서 미니포트 드라이버의 MiniportInitialize 함수로 전달된다.

NdisMQueryAdapterInstanceName 함수는 호의적인 이름을 서술하는 문자열을 위해서 메모리를 할당한다. 호출자가 이 메모리의 사용을 마친 후에 호출자는 메모리를 해제하기 위해서 NdisFreeMemory 함수를 호출해야한다.

호의적인 이름은 사용자가 빠르고 정확하게 물리 NIC 혹은 가상 어댑터를 확인하도록 돕는 경향이 있다. 예를들어 "PCI Ethernet Adapter"와 "Virtual Private Networking Adapter"는 호의적인 이름이다.

NdisMQueryAdapterInstanceName 함수의 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.