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
이전에
반환 값
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) |