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 또는 가상 어댑터에 대한 바인딩을 식별하는 핸들입니다. 일반적으로 NdisBindingHandleNdisOpenAdapterEx 함수에 의해 반환되었습니다.
반환 값
NdisQueryAdapterInstanceNameAdapterInstanceName 문자열에 대한 메모리가 성공적으로 할당된 경우 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) |