NdisIfGetInterfaceIndexFromNetLuid 함수(ndis.h)

아티클
02/26/2024

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

구문

NDIS_STATUS NdisIfGetInterfaceIndexFromNetLuid(
  [in]  NET_LUID     NetLuid,
  [out] PNET_IFINDEX pIfIndex
);

매개 변수

[in] NetLuid

네트워크 인터페이스를 식별하는 NET_LUID 값입니다.

[out] pIfIndex

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

반환 값

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

반환 코드	설명
NDIS_STATUS_SUCCESS	작업이 성공적으로 완료되었습니다.
NDIS_STATUS_INTERFACE_NOT_FOUND	지정된 NET_LUID 등록된 인터페이스 목록에 없기 때문에 NdisIfGetInterfaceIndexFromNetLuid가 실패했습니다.

설명

NDIS 드라이버는 NdisIfGetInterfaceIndexFromNetLuid 함수를 호출하여 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는 다음을 제공합니다. NdisIfGetNetLuidFromInterfaceIndex 함수는 지정된 인터페이스 인덱스와 연결된 NET_LUID 값을 가져옵니다.

요구 사항

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