NdisIfAllocateNetLuidIndex 함수(ndis.h)

  • 아티클

NdisIfAllocateNetLuidIndex 함수는 NDIS 네트워크 인터페이스 공급자에 대한 NET_LUID 인덱스를 할당합니다.

구문

NDIS_STATUS NdisIfAllocateNetLuidIndex(
        NET_IFTYPE ifType,
  [out] PUINT32    pNetLuidIndex
);

매개 변수

ifType

인덱스에 대한 IANA(Internet Assigned Numbers Authority) 인터페이스 형식입니다. 예를 들어 IF_TYPE_ETHERNET_CSMACD(6)은 이더넷과 유사한 인터페이스에 할당된 IfType 의 값입니다. 인터페이스 형식 목록은 NDIS 인터페이스 형식을 참조하세요.

[out] pNetLuidIndex

호출자가 제공한 NET_LUID 인덱스 변수에 대한 포인터입니다. 할당에 성공하면 NdisIfAllocateNetLuidIndex 는 이 변수를 할당된 24비트 NET_LUID 인덱스 값으로 설정합니다.

반환 값

NdisIfAllocateNetLuidIndex 는 다음 값 중 하나를 반환합니다.

반환 코드 설명
NDIS_STATUS_SUCCESS
 작업이 성공적으로 완료되었습니다.
NDIS_STATUS_RESOURCES
 리소스가 부족하여 작업이 실패했습니다.

설명

NDIS 인터페이스 공급자는 NdisIfAllocateNetLuidIndex 함수를 호출하여 NET_LUID 인덱스를 할당합니다. 인터페이스 공급자가 인터페이스를 등록하려면 먼저 인터페이스 공급자가 NET_LUID 인덱스 할당해야 합니다.

NdisIfAllocateNetLuidIndex 는 로컬 컴퓨터에 고유하고 IfType 매개 변수가 지정하는 인터페이스 형식과 연결된 24비트 NET_LUID 인덱스를 할당하려고 시도합니다. NDIS는 영구 스토리지에 NET_LUID 인덱스를 기록하므로 컴퓨터를 다시 시작한 후에도 인덱스가 동일한 인터페이스와 연결될 수 있습니다. NDIS는 인터페이스 공급자가 NdisIfFreeNetLuidIndex 함수를 호출하여 인덱스를 해제할 때까지 NdisIfAllocateNetLuidIndex 의 이후 호출자에게 동일한 NET_LUID 인덱 스를 할당하지 않습니다.

NET_LUID 인덱스 및 인터페이스 형식에서 NET_LUID 값을 작성하기 위해 인터페이스 공급자는 NDIS_MAKE_NET_LUID 매크로를 호출합니다.

인터페이스 공급자는 영구 스토리지에 할당하는 NET_LUID 값을 저장해야 합니다. 예를 들어 컴퓨터 전원이 손실된 경우 공급자는 나중에 NdisIfFreeNetLuidIndex 를 호출하여 더 이상 사용되지 않는 인덱스를 해제할 수 있도록 NET_LUID 값을 영구 스토리지에 저장해야 합니다. 또한 공급자는 동일한 인터페이스를 에 등록할 때마다 동일한 NET_LUID 값을 사용해야 합니다. NdisIfRegisterInterface 함수입니다.

요구 사항

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

추가 정보

NDIS_MAKE_NET_LUID

NET_LUID

NdisIfFreeNetLuidIndex

NdisIfRegisterInterface