ProtocolCmOpenAf
NDIS_STATUS
ProtocolCmOpenAf(
IN NDIS_HANDLE CallMgrBindingContext,
IN PCO_ADDRESS_FAMILY AddressFamily,
IN NDIS_HANDLE NdisAfHandle,
OUT PNDIS_HANDLE CallMgrAfContext
);
|
ProtocolCmOpenAf 함수는 콜 매니저가 주소 패밀리를 여는 연결 지향 NDIS와 상호 작용하기 위해 콜 매니저을 위해 open 당 자원들을 할당하는 데 필요한 함수이다.
매개변수
- CallMgrBindingContext
- 콜 매니저들이 바인딩 당 상태 정보를 유지하는 콜 매니저 할당 컨텍스트 영역에 대한 핸들을 지정한다. 콜 매니저는 NdisOpenAdapter 함수를 호출할 때 이 핸들을 제공한다.
- AddressFamily
- 클라이언트가 여는 주소 패밀리를 지정한다. 이 주소 패밀리는 NdisCmRegisterAddressFamily 함수를 호출할 때 콜 매니저에 의해 등록되어진다.
- NdisAfHandle
- 유일하게 이러한 주소 패밀리 인스턴스를 지정하는 NDIS에 의해 제공되는 핸들을 제공한다. 이 핸들은 콜 매니저에게 불분명하고 시스템을 사용을 위해 예약된다.
- CallMgrAfContext
- 콜 매니저가 제공한 주소 패밀리의 이러한 open에 대한 상태를 유지하는 콜 매니저 제공 컨텍스트 영역에 대한 핸들을 지정한다.
리턴값
ProtocolCmOpenAf 함수는 다음과 같은 하나로 연산들의 상태를 리턴한다.
- NDIS_STATUS_SUCCESS
- 콜 매니저는 성공적으로 클라이언트로부터 주소 패밀리로 요구들을 수락하는 데 필요한 어떤 자원들을 할당하고 초기화했다는 것을 가리킨다.
- NDIS_STATUS_PENDING
- 요구된 연산이 비동기적으로 다루어지는 것을 가리킨다. 콜 매니저는 연산이 완성되었다는 것을 NDIS(그리고 클라이언트)에게 가리키기 위해 열린 AF 연산들을 완성할 때 NdisCmOpenAddressFamilyComplete 함수를 호출해야 한다.
- NDIS_STATUS_RESOURCES
- 콜 매니저는 메모리와 같은 이용할 수 있는 시스템 자원들의 부족때문에 필요한 연산들을 완성할 수 없다는 것을 가리킨다.
- NDIS_STATUS_XXX
- 콜 매니저는 클라이언트가 이러한 주소 패밀리를 연산하기 위한 요구들을 수락할 수 있는 상태로 설정할 수 없다는 것을 가리킨다. 이것은 또하나의 NDIS 라이브러리 함수로부터 전달되는 에러 상태가 될 수 있고 드라이버 개발자에 의해 적당하게 결정된 에러 상태가 될 수 있다.
주석
ProtocolCmOpenAf 함수는 콜 매니저 작업자가 이러한 주소 패밀리의 인스턴스를 여는 클라이언트를 위해 연산들을 행할 필요가 있는 동적 자원들과 구조체들의 필요한 할당을 행한다. 그러한 자원들은 다음과 같은 것으로 제한적이지 않지만 메모리 버퍼들, 데이터 구조체들, 이벤트들, 다른 그러한 유사한 자원들을 포함한다. 콜 매니저는 또한 NDIS에 대한 제어를 리턴하기 전에 open 당 어떤 관계된 데이터를 초기화해야 한다.
콜 매니저는 open당 상태 영역을 할당할 때, 상태 영역의 주소는 NDIS에게 제어를 리턴하기 전에 CallMgrAfContext 핸들을 설정되어져야 한다. 이렇게 하기 위해, CallMgrAfContext 참조를 해제하고 핸들의 값으로 데이터 영역에 대한 포인터를 저장해야 한다. 예를 들어 :
*CallMgrAfContext = SomeBuffer;
만약 ProtocolCmOpenAf 함수가 이러한 주소 패밀리를 연 클라이언트를 위한 계속적인 요구들을 실행하는 데 필요한 open 당 자원들을 할당할 수 없다면, open을 위해 할당한 모든 자원들을 해제해야 하고 NDIS_STATUS_RESOURCES로 NDIS에게 제어를 리턴해야 한다.
만약 ProtocolCmOpenAf 함수가 필요한 연산들을 완성한다면 그리고 CM이 클라이언트로부터 요구들을 수락할 준비가 된다면, ProtocolCmOpenAf 함수는 NDIS_STATUS_SUCCESS의 상태로 가능한 한 빨리 제어를 리턴해야 한다.
ProtocolCmOpenAf 함수는 IRQL DISPATCH_LEVEL로 실행할 수 있게 쓰여져야 한다.
|