NdisIfQueryBindingIfIndex 함수(ndis.h)

NdisIfQueryBindingIfIndex 함수는 지정된 프로토콜 바인딩과 연결된 가장 높고 가장 낮은 계층화된 네트워크 인터페이스에 대한 네트워크 인터페이스 인덱스 및 NET_LUID 값을 검색합니다.

구문

NDIS_STATUS NdisIfQueryBindingIfIndex(
  [in]  NDIS_HANDLE  NdisBindingHandle,
  [out] PNET_IFINDEX pBoundIfIndex,
  [out] PNET_LUID    pBoundIfNetLuid,
  [out] PNET_IFINDEX pLowestIfIndex,
  [out] PNET_LUID    pLowestIfNetLuid
);

매개 변수

[in] NdisBindingHandle

NDIS가 NET_LUID 값 및 네트워크 인터페이스 인덱스를 가져와야 하는 바인딩을 식별하는 핸들입니다. NDIS는 NdisOpenAdapterEx 함수의 NdisBindingHandle 매개 변수에 이 핸들을 제공했습니다.

[out] pBoundIfIndex

호출자가 제공하는 인터페이스 인덱스 변수에 대한 포인터입니다. NdisIfQueryBindingIfIndex가 성공하면 NDIS는 지정된 바인딩과 연결되고 드라이버 스택에서 가장 높은 네트워크 인터페이스의 네트워크 인터페이스 인덱스를 이 변수에 씁니다.

[out] pBoundIfNetLuid

호출자가 제공한 NET_LUID 변수에 대한 포인터입니다. NdisIfQueryBindingIfIndex가 성공하면 NDIS는 지정된 바인딩과 연결되고 드라이버 스택에서 가장 높은 네트워크 인터페이스의 NET_LUID 값을 이 변수에 씁니다.

[out] pLowestIfIndex

호출자가 제공하는 인터페이스 인덱스 변수에 대한 포인터입니다. NdisIfQueryBindingIfIndex가 성공하면 NDIS는 지정된 바인딩과 연결되고 드라이버 스택에서 가장 낮은 네트워크 인터페이스의 네트워크 인터페이스 인덱스를 이 변수에 씁니다.

[out] pLowestIfNetLuid

호출자가 제공한 NET_LUID 변수에 대한 포인터입니다. NdisIfQueryBindingIfIndex가 성공하면 NDIS는 지정된 바인딩과 연결되고 드라이버 스택에서 가장 낮은 네트워크 인터페이스의 NET_LUID 값을 이 변수에 씁니다.

반환 값

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

반환 코드	설명
NDIS_STATUS_SUCCESS	작업이 성공적으로 완료되었습니다.
NDIS_STATUS_INTERFACE_NOT_FOUND	지정된 바인딩이 등록된 인터페이스와 연결되지 않아 NdisIfQueryBindingIfIndex가 실패했습니다.

설명

NDIS 프로토콜 드라이버는 NdisIfQueryBindingIfIndex 함수를 호출하여 바인딩과 연결된 네트워크 인터페이스 인덱스 및 NET_LUID 값을 검색할 수 있습니다.

NdisIfQueryBindingIfIndex 는 바인딩과 연결된 가장 높은 인터페이스 및 가장 낮은 인터페이스에 대한 NET_LUID 값과 인터페이스 인덱스를 제공합니다. 예를 들어 지정된 바인딩과 직접 연결된 미니포트 어댑터가 필터 중간 드라이버의 가상 미니포트이거나 미니포트 어댑터를 통해 구성된 필터 모듈이 있는 경우와 같은 값은 다릅니다.

프로토콜 드라이버는 NDIS_BIND_PARAMETERS 구조의 드라이버 스택에서 가장 높고 가장 낮은 인터페이스의 인터페이스 인덱스 및 NET_LUID 가져올 수도 있습니다.

요구 사항

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

추가 정보

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx