NdisMCmCreateVc

NDIS_STATUS

  NdisMCmCreateVc(

    IN NDIS_HANDLE  MiniportAdapterHandle,

    IN NDIS_HANDLE  NdisAfHandle,

    IN NDIS_HANDLE  MiniportVcContext,

    OUT PNDIS_HANDLE  NdisVcHandle

    );

NdisMCmCreateVc함수는 MCM미니포트가 들어오는 호출 제안을 클라이언트에게 전달하는것에대한 연결 엔트포인트를 설정한다.

매개변수

MiniportAdapterHandle
MiniportInitialize에대한 처음 입력 NDIS제공 핸들을 지정한다.

NdisAfHandle
들어오는 호출의 타겟인 클라이언트를 확인하는 핸들을 지정한다. MCM드라이버는 이 핸들을 ProtocolCmOpenAf함수의 입력 파라미터로써 얻는다.

MiniportVcContext
MCM드라이버가 이 VC에대한 상태를 유지하는 호출자 제공 상주 컨텍스트 영역에대한 핸들을 지정한다. 만약 NdisMCmCreateVc함수에대한 호출이 성공적이라면, NDIS는 이 핸들을 다시 이 VC와 관계된 모든 순차적인 호출들에서의 MCM미니포트에게 넘긴다.

NdisVcHandle
NdisMCmCreateVc함수가 호출되기전에 NULL로 초기화되어야만하는 호출자 제공 변수를 가리킨다. 성공적인 호출로부터 리턴되자마자, 이 변수는 새롭게 생성된 VC에대한 NDIS제공 핸들로 설정되어야만 한다. 호출자는 이 VC와 관계된 연결지향 NdisXxx함수들에대한 순차적인 호출에대한 이 핸들을 저장한다.

리턴값

NdisMCmCreateVc함수는 다음중 하나를 리턴한다.:

NDIS_STATUS_SUCCESS
NDIS가 성공적으로 VC를 만들었을때.

NDIS_STATUS_RESOURCES
NDIS가 VC를 설정하기위한 충분한 메모리를 할당하지 못할때.

NDIS_STATUS_FAILURE
주어진 NdisAfHandle가 무효할때.

NDIS_STATUS_XXX
클라이언트는 몇가지 이유로 VC의 생성에 실패하고, NDIS는 ProtocolCoCreateVc함수에의해 리턴된 에러 상태를 MCM드라이버에게 전달한다.

주석

MCM드라이버는 이미 MCM드라이버로 등록된 SAP에게 다이렉트된 리모트 노드로부터 연들어오는 연결 제안을 나타내기위해 NdisMCmCreateVc함수로 VC를 생성한다.

VC생성과정에서, NDIS는 NdisVcHandle을 클라이언트와 MCM미니포트에게 전달한다. 이 핸들은 주어진 VC와 관계된 순차적인 요청들이 다이렉트되기위한 클라이언트와 미니포트에대한 가상 연결을 확인한다.

일반적으로, NdisMCmCreateVc함수의 호출들은 리턴된 NdisVcHandle을 호출자 할당 상태영역인 MiniportVcContext에 저장한다. NDIS는 MCM드라이버가 VC를 생성할때마다, NdisVcHandle을 입력파라미터로써 적절한 클라이언트의 ProtocolCoCreateVc함수에게 넘긴다.

MCM드라이버가 등록된SAP들중 하나를 다이렉트하는 들어오는 호출의 제안을 처리할때, 우선 NdisMCmCreateVc를 호출해야만 한다. 동기적인 연산으로써, NDIS는 NdisMCmCreateVc함수가 컨추럴을 리턴하기전에 클라이언트의 ProtocolCoCreateVc함수를 호출한다. 만약 NdisMCmCreateVc함수에대한 호출이 성공이라면, MCM미니포트는 적절한 클라이언트에게 알리면서, 리턴된 값을 NdisMCmDispatchIncomingCall함수의 NdisVcHandle에 넘길수 있다.

드라이버 개발자는 MCM미니포트가 (내부적으로) 드라이버가 나가고 들어오는 호출들에대한 연결을 설정하는 컨텍스내에서 호출하는 MiniportCoCreateVc함수를 가지고 있는지를 결정한다.

단지 통합적인 콜 매니지먼트를 제공하는 연결지향 닉 드라이버들만이 NdisMCmCreateVc함수를 호출할수 있다. 스스로를 NDIS에게 프로토콜로써 등록하는 독립적인 콜매니저와 클라이어트들은 대신 NdisCoCreateVc함수를 호출한다.

NdisMCmCreateVc함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작 될 수 있다.