ProtocolClOpenAfComplete

VOID 

  ProtocolClOpenAfComplete(

      IN NDIS_STATUS  Status,

      IN NDIS_HANDLE  ProtocolAfContext,

      IN NDIS_HANDLE  NdisAfHandle

      );

모든 연결 지향 NDIS 클라이언트들은 그들이 NdisClOpenAddressFamily로 초기화한 비동기 연산들을 완성하기 위해 ProtocolClOpenAfComplete 함수들을 가져야 한다.

매개변수

Status
다음과 같은 어떤 값이 될 수 있는 NdisClOpenAddressFamily 함수에 대한 클라이언트의 호출의 마지막 상태를 지정한다.

NDIS_STATUS_SUCCESS
주소 패밀리가 열려있어서 클라이언트는 NdisCoRequest, NdisCoCreateVc, NdisClRegisterSap 함수같은 NDIS 함수들에 대한 연속적인 호출에서 리턴된 NdisAfHandle을 사용할 수 있고 ProtocolAfContext에 상태를 호기화할 수 있다.

NDIS_STATUS_RESOURCES
요구된 연산이 NDIS 혹은 콜 매니저가 충분한 메모리를 할당할 수 없거나 그들중 하나가 이러한 주소 패밀리의 클라이언트의 open을 추적하기 위해 사용한 상태를 초기화할 수 없다.

NDIS_STATUS_FAILURE
NDIS는 다음과 같은 이유들 중 하나로 이러한 호출을 실패한다.

  • 주어진 주소 패밀리가 호출가 바인드된 아래 NIC 미니포트를 위해 등록된 AF와 일치하지 않다.

  • 호출자가 NdisClOpenAddressFamily 함수에 ClCharacteristics에 유효하지 않거나 불충분한 정보를 제공한다.

  • 호출자의 어댑터 바인딩이 닫혀있다.

  • 주어진 주소 패밀리를 등록한 콜 매니저는 어댑터 바인딩을 닫는다.

ProtocolAfContext
이러한 주소 패밀리를 위한 AF당 컨텍스트 영역에 대한 클라이언트 제공 핸들을 지정한다. 클라이언트는 이러한 영역을 할당하고 NdisClOpenAddressFamily 함수에 대한 호출에서 NDIS에게 이러한 핸들을 전달한다.

NdisAfHandle
만약 Status가 NDIS_STATUS_SUCCESS이면, 클라이언트와 같은 연결 지향 NIC 드라이버에 바인드된 특정 콜 매니저 사이에 NDIS와 설립된 관련을 표시하는 이러한 주소 패밀리에 대한 NIDS 제공 유효한 핸들을 지정한다. 그렇지 않으면, 이러한 매개변수는 NULL이다. 클라이언트는 항상 NdisCl/CoXxx 함수들에 대한 계속적인 호출에서 ProtocolAfContext 영역에 항상 유효한 핸들을 저장해야 한다.

주석

ProtocolClOpenAfComplete 함수에 대한 호출은 다음과 같은 것의 몇몇 혹은 모든 발생하는 것을 가리킨다.

  • NDIS는 클라이언트의 ProtocolCoAfRegisterNotify 함수가 NdisClOpenAddressFamily 함수로 전달하는 몇몇 매개변수들을 검사한다. 만약 모든 것이 유효하다면, NDIS는 클라이언트의 ProtocolClXxx 엔트리 포인트들을 저장한다. 그러면, NDIS는 NDIS에게 특정 주소 패밀리를 등록한 콜 매니저의 ProtocolCmOpenAf 함수를 호출한다.

  • 콜 매니저는 (혹은 만약 미니포트가 통합 콜 관리 기능을 가진 NIC을 제어한다면 MCM 드라이버) 클라이언트의 ProtocolCoAfRegisterNotify 함수가 AddressFamily에 NdisClAddressFamily로 전달하는 그리고 이러한 콜 매니저가 NDIS에게 유효한지를 리턴하는 사양을 조사한다.

만약 클라이언트의 주소 패밀리를 여는 시도가 실패한다면, NDIS는 클라이언트가 NdisClOpenAddressFamily 함수에 대한 호출로 할당한 자원들을 해제할 수 있거나 혹은 재사용을 위해 준비할 수 있는 ProtocolClOpenAfComplete 함수를 호출하기 전에 저장된 상태를 지워야 한다.

그렇지 않으면, ProtocolClOpenAfComplete 함수는 클라이언트가 새롭게 열린 AF에서 계속적인 연산들을 위해 필요할 클라이언트 결정 상태가 무엇이든지 설정해야 한다. 특히, 클라이언트는 항상 클라이언트의 ProtocolAfContext 영역내에 입력 NdisAfHandle를 저장해야 한다. 예를 들어, ProtocolClOpenAfComplete 함수는 또한 클라이언트가 계속해서 필요할 SAP당, VC당, party당 컨텍스트 영역들의 동적 할당과 해제들을 위해 한번 혹은 여러번 준비로 NdisInitializeNPagedLookasideList 함수를 호출할 것이다.

만약 들어오는 호출들을 수락한다면, 클라이언트는 SAP당 상태 영역을 할당하는 처리를 할 것이고 NdisClRegisterSap 함수를 호출할 것이다. 만약 나가는 호출들을 한다면, 클라이언트는 VC당 상태를 할당하기 위해 처리할 것이고 리모트 노드에 나가는 호출을 하는 자신의 클라이언트들의 하나로부터 들어오는 요구의 기대로 NdisCoCreateVc 함수로 VC를 만들 것이다.

ProtocolClOpenAfComplete 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.