NdisCoAssignInstanceName

NDIS_STATUS NdisCoAssignInstanceName( IN NDIS_HANDLE NdisVcHandle, IN PNDIS_STRING BaseInstanceName, OUT PNDIS_STRING VcInstanceName );

NdisCoAssignInstanceName함수는 VC에대한 인스턴스 네임을 할당하고 NDIS로 하여금 Windows Management Instrumentation (WMI)로 할당된 이름에대한 GUID(글러벌하게 유일한 확인자)를 등록 하도록 한다.

매개변수

NdisVcHandle

이름 붙여지는 핸들을 지정한다. 이 핸들은 VC가 처음에 NdisCoCreateVc함수로 생성됐을때 NDIS에의해 제공된다. 나가는 호출에대한 준비에 있어서의 클라이언트에의해 혹은 클라이언트로 들어오는 호출을 급파하는 것에대한 준비에있어서의 콜매니저에의해서든.

BaseInstanceName

VC의 기본 이름을 지정하는 호출자 제공 유니코드 스트링의 포인터. 기본이름은 미니포트 범위내에서 다른 이름 붙여진 VC들과 그VC를 유일하게 확인하는 어떤 국부적인 유니코드 스트링일수 있다.

VcInstanceName

이 루틴이 VC를 위해 할당한 NDIS할당 인스턴스 이름을 지정하는 유니코드 스트링을 리턴하는것에대한 호출자 할당 버퍼의 포인터.

리턴값

NdisCoAssignInstanceName함수는 다음중 어떤것을 리턴한다.:

NDIS_STATUS_SUCCESS

NDIS는 VC를 지정하기위해 인스턴스 네임을 할당하고 WMI로 인스턴스 네임에대한 GUID를 등록한다.

NDIS_STATUS_FAILURE

VC에대한 인스턴스를 할당하는 시도가 실패했다.

NDIS_STATUS_RESOURCES

NDIS는 인스턴스 네임에대한 버퍼를 할당할수 없다.

주석

NdisCoCreateVC함수로 VC의 설정을 초기화한후, 콜 매니저 혹은 연결지향 클라이언트는 NdisCoAssignInstanceName함수로 VC를 이름지을수 있다. NdisCoAssignInstanceName함수의 호출은 NDIS로 하여금 VC에대한 인스턴스 네임을 할당하도록 하고 WMI로 그 인스턴스 네임을 등록 하도록 한다. WMI클라이언트는 그리고나서 VC를 열거할수 있고 VC와 관계된 OID들을 쿼리하고 설정할수 있다.

통합 미니포트 콜매니저(MCM)은 그 VC들을 이름짓기위해 NdisCoAssignInstanceName함수를 사용하지 않는다. 대신, MCM은 VC에대한 커스텀 GUID와 OID를 생성해야하고 NDIS로 GUID-to-OID 맵핑을 등록한다.

NDIS는 지정된 VC에대한 인스턴스 이름을 호출자에의해 지정된 기본 이름에대한 인덱스를 붙이면서 생성한다. NDIS는 완전한 인스턴스 네임(기본이름+인덱스)을 호출자에게 리턴하고 WMI로 인스턴스 이름에대한 GUID를 등록한다. 단지 이름 붙여진 VC들만이 열거될수 있고 WMI클라이언트에의해 쿼리될수 있다. 이름이 없는 VC들은 WMI클라이언트에게 보이지 않는다.

만약 지정한 VC가 이미 인스턴스 네임(이전의 호출에서 NdisCoAssignInstanceName함수에의해 할당된)을 같고 있다면, NDIS는 NDIS_STATUS_SUCCESS를 리턴하고 VC에대해서 처음에 할당된 인스턴스 이름을 리턴한다. 인스턴스 네임은 그 VC가 제거될때까지 할당된채 남아있는다.

호출자는 리턴된 인스턴스 이름을 NDIS가 이전에 NdisCoCreateVc함수로 부터 호출자에게 리턴한 이름지어진 VC에대한 핸들과 연관 시킬수 있다. 그러나 NDIS는 다음의 순차적인 호출에서의 VC를 가리키기위해 인스턴스 이름이 아닌 VC핸들을 사용할 것이다. NdisCoAssignInstanceName 함수의 호출자는 다른 어떤 메니저먼트 본질에대한 인스턴스 이름을 리턴할 필요를 찾을 것이다.

호출자는 리턴된 인스턴스를 포함하는 버퍼를 해제할 책임이 있다. NdisCoDeleteVc함수로 이름 붙여진 VC를 삭제한후, 호출자는 NdisFreeString함수로 버퍼를 해제해야만 한다.

NdisCoAssignInstanceName 함수의 호출자는 IRQL DISPATCH_LEVEL에서 동작 되어야만한다.