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)

추가 정보

MiniportInitializeEx

NdisFreeMemory

UNICODE_STRING