NdisCoAssignInstanceName 함수(ndis.h)

아티클
08/07/2023

NdisCoAssignInstanceName은 VC에 instance 이름을 할당하고 NDIS가 할당된 이름에 대한 GUID(전역적으로 고유한 식별자)를 WMI(Windows Management Instrumentation)에 등록하도록 합니다.

구문

NDIS_STATUS NdisCoAssignInstanceName(
  [in]            NDIS_HANDLE  NdisVcHandle,
  [in]            PNDIS_STRING BaseInstanceName,
  [out, optional] PNDIS_STRING VcInstanceName
);

매개 변수

[in] NdisVcHandle

명명되는 VC에 대한 핸들을 지정합니다. 이 핸들은 NDIS에서 NdisCoCreateVc를 사용하여 VC를 만들었을 때 발신 호출을 준비하기 위해 클라이언트에서 또는 클라이언트에 들어오는 호출을 디스패치하기 위한 준비를 위해 호출 관리자에 의해 제공되었습니다.

[in] BaseInstanceName

VC의 기본 이름을 지정하는 호출자 제공 유니코드 문자열을 설명하는 NDIS_STRING 형식에 대한 포인터입니다. 기본 이름은 미니포트 드라이버의 scope 내의 다른 명명된 VC와 관련하여 VC를 고유하게 식별하는 지역화 가능한 유니코드 문자열일 수 있습니다. Windows Vista 이상에서 NDIS는 NDIS_STRING 형식을 UNICODE_STRING 형식으로 정의합니다.

[out, optional] VcInstanceName

이 루틴이 VC에 할당된 NDIS 할당 instance 이름을 지정하는 유니코드 문자열을 반환하는 호출자가 할당한 NDIS_STRING 형식에 대한 포인터입니다.

반환 값

NdisCoAssignInstanceName 은 다음 중 어느 것을 반환할 수 있습니다.

반환 코드	설명
NDIS_STATUS_SUCCESS	NDIS는 지정된 VC에 instance 이름을 할당하고 WMI를 사용하여 instance 이름의 GUID를 등록했습니다.
NDIS_STATUS_FAILURE	VC에 instance 이름을 할당하지 못했습니다.
NDIS_STATUS_RESOURCES	NDIS에서 instance 이름에 버퍼를 할당할 수 없습니다.

설명

NdisCoCreateVc를 사용하여 VC 설정을 시작한 후 호출 관리자 또는 연결 지향 클라이언트는 VC의 이름을 NdisCoAssignInstanceName으로 지정할 수 있습니다. NdisCoAssignInstanceName을 호출하면 NDIS가 VC에 instance 이름을 할당하고 instance 이름을 WMI에 등록합니다. 그런 다음 WMI 클라이언트는 VC를 열거하고 VC를 기준으로 OID를 쿼리하거나 설정할 수 있습니다.

MCM(통합 미니포트 호출 관리자) 드라이버는 NdisCoAssignInstanceName 을 사용하여 VC의 이름을 지정할 수 없습니다. 대신 MCM 드라이버는 VC에 대한 사용자 지정 GUID 및 OID를 만들고 GUID-OID 매핑을 NDIS에 등록해야 합니다.

NDIS는 호출자가 가리키는 기본 이름에 인덱스를 추가하여 지정된 VC에 대한 instance 이름을 만듭니다. NDIS는 전체 instance 이름(기본 이름 + 인덱스)을 호출자에게 반환한 다음 WMI를 사용하여 instance 이름의 GUID를 등록합니다. 명명된 VC만 WMI 클라이언트에서 열거 및 쿼리할 수 있습니다. 명명되지 않은 VC는 WMI 클라이언트에 표시되지 않습니다.

지정된 VC에 이미 instance 이름(NdisCoAssignInstanceName에 대한 이전 호출에서 할당됨)이 있는 경우 NDIS는 NDIS_STATUS_SUCCESS 및 VC에 할당된 원래 instance 이름을 반환합니다. instance 이름은 해당 VC가 삭제될 때까지 VC에 할당된 상태로 유지됩니다.

호출자는 반환된 instance 이름을 NDIS가 이전에 NdisCoCreateVc에서 호출자에게 반환한 명명된 VC의 핸들과 연결할 수 있습니다. 그러나 NDIS는 후속 호출에서 VC를 참조하기 위해 instance 이름이 아닌 VC 핸들을 계속 사용합니다. NdisCoAssignInstanceName의 호출자는 instance 이름을 다른 관리 엔터티로 반환해야 할 수도 있습니다.

호출자는 반환된 instance 이름을 포함하는 버퍼를 해제해야 합니다. NdisCoDeleteVc를 사용하여 명명된 VC를 삭제한 후 호출자는 NdisFreeString을 사용하여 버퍼를 해제해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(NdisCoAssignInstanceName(NDIS 5.1) 참조)에 대해 지원됩니다. Windows XP에서 NDIS 5.1 드라이버(NdisCoAssignInstanceName(NDIS 5.1) 참조)에 대해 지원됩니다.
대상 플랫폼	데스크톱
머리글	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	DISPATCH_LEVEL
DDI 규정 준수 규칙	Irql_Connection_Function(ndis)