MiniportCoCreateVc

NDIS_STATUS MiniportCoCreateVc( IN NDIS_HANDLE MiniportAdapterContext, IN NDIS_HANDLE NdisVcHandle, OUT PNDIS_HANDLE MiniportVcContext );

MiniportCoCreateVc는 연결 지향 미니포트들을 위해 필요한 함수이다. MiniportCoCreateVc는 새로운 VC가 만들어지는 미니포트에게 인디케이트하기 위해 NDIS에 의해 호출되어진다.

매개변수

MiniportAdapterContext

어댑터의 이러한 인스턴스에 대해 미니포트가 상태 정보를 유지하는 데에 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정한다. 미니포트는 MiniportInitialize 함수로부터 NdisMSetAttributes 혹은 NdisMSetAttributesEx를 호출함으로써 NDIS에게 이 핸들을 제공한다.

NdisVcHandle

만들어진 VC를 유일하게(uniquely) 지정하기 위해 NDIS에 의해 제공된 핸들을 지정한다. 이 핸들은 미니포트에게 불투명하고 NDIS 라이브러리를 위해 사용이 예약되었다.

MiniportVcContext

미니포트가 VC에 대하여 상태를 유지하는 미니포트 제공 컨텍스트 영역에 대한 핸들을 지정한다. 이 값은 출력값이다.

NDIS_STATUS_SUCCESS

미니포트가 성공적으로 모든 필요한 자원들을 할당하고 새롭게 만들어진 VC를 위해 요구들을 다루기 위해 그 자체가 준비가 되었다는 것을 가리킨다.

NDIS_STATUS_RESOURCES

콜 매니저는 동적으로 새로운 VC를 운영하기 위해 필요한 동적으로 할당된 자원들을 얻을 수 없다.

주석

MiniportCoCreateVc는 동기화 함수로 쓰여져야 하고 어떤 환경에서는 시스템-wide 실패를 야기하는 것 없이 NDIS_STATUS_PENDING을 리턴할 수 없다.

MiniportCoCreateVc는 미니포트가 VC에 대하여 상태 정보를 유지하는데 필요한 자원들을 할당한다. 자원들은 메모리 버퍼들, 이벤트들, 데이터 구조체들, 다른 그러한 유사한 자원들을 포함하지만은 제한되지는 않는다.

모든 필요한 자원들을 할당한 후 미니포트는 사용할 수 있는 상태로 자원들을 초기화해야 하고 MiniportVcContext내에 상태 영역에 대한 포인터를 리턴해야 한다. 핸들은 핸들을 디레퍼런스함으로써 그리고 핸들의 값으로서 상태 버퍼에 대한 포인터를 저장함으로써 설정된다. 예를 들어,

   *MiniportVcContext = SomeBuffer;

MiniportCoCreateVc는 IRQL DISPATCH_LEVEL에서 실행되어질 수 있게 짜여진다.