NdisQueryAdapterInstanceName

NDIS_STATUS NdisQueryAdapterInstanceName( OUT PNDIS_STRING AdapterInstanceName, IN NDIS_HANDLE NdisBindingHandle );

NdisQueryAdapterInstanceName 함수는 호출하는 프로토콜과 바이딩된 물리 NIC 혹은 가상 어댑터의 호의적인 이름을 얻는다.

매개변수

AdapterInstanceName

카운트된 유니코드 문자열을 받은 호출자 제공 변수를 가리킨다. 이 문자열은 바인딩이 참조하는 인터페이스의 호의적인 이름을 서술한다. 이 인터페이스는 물리 NIC 혹은 가상 어댑터이다.

NdisBindingHandle

호출자가 바인딩한 다음 하위 드라이버의 타겟 NIC 혹은 가상 어댑터를 확인하는 핸들을 서술한다. 전형적으로NdisBindingHandle은 NdisOpenAdapter 함수에 의해서 리턴된다.

리턴값

AdapterInstanceName에 문자열에 대한 메모리가 성공적으로 할당됐다면 NdisQueryAdapterInstanceName 함수는 NDIS_STATUS_SUCCESS를 리턴한다; 그렇지 않으면 NDIS_STATUS_RESOURCES를 리턴한다.

주석

프로토콜이 바인딩한 물리 NIC 혹은 가상 어댑터의 호의적인 이름을 얻기 위해서 프로토콜 드라이버는 NdisQueryAdapterInstanceName 함수를 사용한다. 프로토콜 드라이버는 NdisBindingHandle에서 그러한 NIC 혹은 가상 어댑터에 대한 핸들을 서술한다. 프로토콜 드라이버는 이 핸들을 얻기 위해서 NdisOpenAdapter 함수를 호출할 수 있다.

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

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

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