NdisQueryAdapterInstanceName 함수(ndis.h)

  • 아티클

NdisQueryAdapterInstanceName 함수는 호출 프로토콜 드라이버가 바인딩된 실제 NIC 또는 가상 어댑터의 식별 이름을 검색합니다.

구문

NDIS_STATUS NdisQueryAdapterInstanceName(
       PNDIS_STRING pAdapterInstanceName,
  [in] NDIS_HANDLE  NdisBindingHandle
);

매개 변수

pAdapterInstanceName

계산된 유니코드 문자열을 수신하는 호출자가 제공한 NDIS_STRING 형식에 대한 포인터입니다. 이 문자열은 바인딩이 참조하는 인터페이스의 이름을 지정합니다. 이 인터페이스는 물리적 NIC 또는 가상 어댑터입니다. Windows 2000 이상에서 NDIS는 NDIS_STRING 형식을 UNICODE_STRING 형식으로 정의합니다.

[in] NdisBindingHandle

호출자가 바인딩된 다음 하위 드라이버의 대상 실제 NIC 또는 가상 어댑터에 대한 바인딩을 식별하는 핸들입니다. 일반적으로 NdisBindingHandle 은 NdisOpenAdapterEx 함수에 의해 반환되었습니다.

반환 값

NdisQueryAdapterInstanceName 은 AdapterInstanceName 의 문자열에 대한 메모리가 성공적으로 할당된 경우 NDIS_STATUS_SUCCESS 반환합니다. 그렇지 않으면 NDIS_STATUS_RESOURCES 반환됩니다.

설명

프로토콜 드라이버는 NdisQueryAdapterInstanceName 을 사용하여 프로토콜 드라이버가 바인딩된 실제 NIC 또는 가상 어댑터의 식별 이름을 검색합니다. 프로토콜 드라이버는 NdisBindingHandle 에서 이러한 NIC 또는 가상 어댑터에 대한 핸들을 지정합니다. 프로토콜 드라이버는 NdisOpenAdapterEx 함수를 호출하여 이 핸들을 검색합니다.

NdisQueryAdapterInstanceName 은 식별 이름을 지정하는 문자열에 대한 메모리를 할당합니다. 호출자가 이 메모리 사용을 완료한 후 호출자는 NdisFreeMemory 함수를 호출하여 메모리를 해제해야 합니다.

친숙한 이름은 사용자가 실제 NIC 또는 가상 어댑터를 빠르고 정확하게 식별하는 데 도움이 되도록 하기 위한 것입니다. 예를 들어 "PCI 이더넷 어댑터" 및 "가상 프라이빗 네트워킹 어댑터"는 친숙한 이름으로 간주됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(NdisQueryAdapterInstanceName(NDIS 5.1) 참조)에 대해 지원됩니다. Windows XP에서 NDIS 5.1 드라이버(NdisQueryAdapterInstanceName(NDIS 5.1) 참조)에 대해 지원됩니다.
대상 플랫폼 데스크톱
머리글 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 규정 준수 규칙 Irql_Miscellaneous_Function(ndis)

추가 정보

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING