NdisMQueryAdapterInstanceName 함수(ndis.h)
NdisMQueryAdapterInstanceName 함수는 미니포트 어댑터의 이름을 검색합니다.
구문
NDIS_STATUS NdisMQueryAdapterInstanceName(
PNDIS_STRING pAdapterInstanceName,
NDIS_HANDLE MiniportHandle
);
매개 변수
pAdapterInstanceName
계산된 유니코드 문자열을 수신하는 호출자가 제공한 NDIS_STRING 형식에 대한 포인터입니다. 이 문자열은 지정된 미니포트 어댑터의 인터페이스 이름을 지정합니다. Windows Vista 이상 버전의 Windows 운영 체제에서 NDIS는 NDIS_STRING 형식을 UNICODE_STRING 형식으로 정의합니다.
MiniportHandle
이전에 에 입력된 미니포트 어댑터에 대한 핸들입니다. MiniportInitializeEx 함수입니다.
반환 값
AdapterInstanceName에서 문자열에 대한 메모리가 성공적으로 할당된 경우 NDIS_STATUS_SUCCESS 반환합니다. 그렇지 않으면 NDIS_STATUS_RESOURCES 반환합니다.
설명
미니포트 드라이버는 NdisMQueryAdapterInstanceName 을 사용하여 미니포트 드라이버가 제어하는 인터페이스의 이름을 검색합니다. 이 인터페이스는 물리적 NIC 또는 가상 어댑터이며 미니포트 어댑터라고 합니다. 미니포트 드라이버는 MiniportAdapterHandle 에서 미니포트 어댑터에 대한 핸들을 지정합니다. 미니포트 어댑터에 대한 이 핸들은 미니포트 드라이버의 MiniportInitializeEx 함수에 전달되어 네트워크 I/O 작업에 대한 미니포트 어댑터를 설정합니다.
NdisMQueryAdapterInstanceName 은 친숙한 이름을 지정하는 문자열에 대한 메모리를 할당합니다. 호출자가 이 메모리 사용을 완료한 후 호출자는 NdisFreeMemory 함수를 호출하여 메모리를 해제해야 합니다.
친숙한 이름은 사용자가 물리적 NIC 또는 가상 어댑터를 빠르고 정확하게 식별하는 데 도움이 되도록 하기 위한 것입니다. 예를 들어 "PCI 이더넷 어댑터" 및 "가상 프라이빗 네트워킹 어댑터"는 친숙한 이름으로 간주됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | NDIS 5.1 및 NDIS 6.0 이상에서 지원됩니다. NDIS 5.1 드라이버의 경우 NdisMQueryAdapterInstanceName(NDIS 5.1)을 참조하세요. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | ndis.h(Ndis.h 포함) |
| 라이브러리 | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI 규정 준수 규칙 | Irql_Miniport_Driver_Function(ndis) |