NdisIfGetNetLuidFromInterfaceIndex 함수(ndis.h)

아티클
08/07/2023

NdisIfGetNetLuidFromInterfaceIndex 함수는 네트워크 인터페이스 인덱스와 연결된 NET_LUID 값을 가져옵니다.

구문

NDIS_STATUS NdisIfGetNetLuidFromInterfaceIndex(
        NET_IFINDEX ifIndex,
  [out] PNET_LUID   pNetLuid
);

매개 변수

ifIndex

NDIS가 의 NET_LUID 값에 할당한 네트워크 인터페이스 인덱스 NdisIfRegisterInterface 함수입니다.

[out] pNetLuid

호출자가 제공한 NET_LUID 변수에 대한 포인터입니다. NdisIfGetNetLuidFromInterfaceIndex가 성공하면 NDIS는 지정된 네트워크 인터페이스 인덱스와 연결된 NET_LUID 값을 이 변수에 씁니다.

반환 값

NdisIfGetNetLuidFromInterfaceIndex는 다음 상태 값 중 하나를 반환합니다.

반환 코드	설명
NDIS_STATUS_SUCCESS	작업이 성공적으로 완료되었습니다.
NDIS_STATUS_INTERFACE_NOT_FOUND	지정된 네트워크 인터페이스 인덱스가 등록된 인터페이스에 할당되지 않아 NdisIfGetNetLuidFromInterfaceIndex가 실패했습니다.

설명

NDIS 드라이버는 NdisIfGetNetLuidFromInterfaceIndex 함수를 호출하여 네트워크 인터페이스 인덱스와 연결된 NET_LUID 값을 가져올 수 있습니다.

NDIS 프록시 공급자 서비스가 관리하는 인터페이스의 경우 NDIS는 인터페이스 인덱스와 다양한 드라이버 초기화 구조의 NET_LUID 제공합니다.

미니포트 드라이버는 의 미니포트 어댑터에 대한 인터페이스 인덱스 및 NET_LUID 가져올 수 있습니다. NDIS_MINIPORT_INIT_PARAMETERS 구조체입니다.
필터 드라이버는 의 필터 모듈에 대한 인터페이스 인덱스 및 NET_LUID 가져올 수 있습니다. NDIS_FILTER_ATTACH_PARAMETERS 구조체입니다.
프로토콜 드라이버는 NDIS_BIND_PARAMETERS 구조의 드라이버 스택에서 가장 높고 낮은 인터페이스의 인터페이스 인덱스와 NET_LUID 가져올 수 있습니다.

NDIS는 인터페이스 공급자가 NdisIfRegisterInterface 함수를 호출할 때 인터페이스 인덱스를 네트워크 인터페이스에 할당합니다. 인터페이스 공급자는 NDIS_MAKE_NET_LUID 매크로를 호출하여 인터페이스를 등록하기 전에 NET_LUID 값을 만듭니다.

인터페이스 인덱스 값은 컴퓨터를 다시 시작하지 않고 변경할 수 있습니다. NET_LUID 값과 연결된 인터페이스를 등록 취소하고 다시 등록하면 인터페이스 인덱스 값이 다를 수 있습니다. 인터페이스 인덱스를 컴퓨터를 다시 시작한 후에도 유지되는 NET_LUID 인덱스와 혼동하지 마세요.

NDIS는 다음을 제공합니다.지정된 NET_LUID 대한 인터페이스 인덱스를 가져오는 NdisIfGetInterfaceIndexFromNetLuid 함수입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.0 이상에서 지원됩니다.
대상 플랫폼	데스크톱
머리글	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	Irql_Interfaces_Function(ndis)