NdisCmOpenAddressFamilyComplete

VOID NdisCmOpenAddressFamilyComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE NdisAfHandle, IN NDIS_HANDLE CallMgrAfContext );

NdisCmOpenAddressFamilyComplete함수는 콜 매니저가 클라이언트의 처음 오픈-AF요청에대한 응답으로 NDIS_STATUS_PENDING를 리턴한후, 지정한 클라이언트에대한 주어진 AF의 독립적인 콜 매니저의 오픈의 마지막 상태를 리턴한다.

매개변수

Status

open-AF연산의 마지막 상태를 지정한다. NDIS_STATUS_SUCCESS 혹은 NDIS_STATUS_PENDING를 제외한 어떤 CM-의존 error NDIS_STATUS_XXX.

NdisAfHandle

콜 매니저의 ProtocolCmOpenAf함수로 입력하는 NDIS제공 핸들을 지정한다. 이것은 NDIS_STATUS_PENDING를 리턴한다.

CallMgrAfContext

만약 OPEN이 성공이면,콜 매니저가 NdisAfHandle를 포함하는 이 어드레스 패밀리의 클라이언트의 오픈에대한 상태를 유지하는 호출자 할당 상주 컨텍스트 영역에대한 핸들을 지정한다. 만약 Status가 NDIS_STATUS_SUCCESS이면, NDIS는 이 파라미터를 무시한다.

주석

독립적인 콜 매니저는 만약 ProtocolCmOpenAf함수가 이전에 주어진 NdisAfHandle에대해 NDIS_STATUS_PENDING을 리턴한다면, NdisCmOpenAddressFamilyComplete함수를 호출해야만 한다. NdisClOpenAddressFamily함수에 대한 호출로 지연된 AF를 열기위한 연산을 초기화하는 클라이언트는 NdisCmOpenAddressFamilyComplete함수가 그 클라이언트의 ProtocolClOpenAfComplete함수를 호출하도록 할때까지 같은 바인딩에대한 연결지향 연산을 수행할수 없다.

만약 NdisCmOpenAddressFamilyComplete함수에 대한 호출이 Status에 NDIS_STATUS_SUCCESS를 설정한다면, 클라이언트가 그 AF를 닫을때까지 NDIS는 순차적으로 주어진 CallMgrAfContext핸들을 클라이언트의 어드레스 페밀리에대한 OPEN으로 간주하는 모든 CM제공 ProtocolCmXxx함수와 ProtocolCoXxx함수에대한 입력 파라미터로써 넘긴다. 콜 매니저는 NdisCmOpenAddressFamilyComplete함수의 실패 상태를 넘기기전에 할당했던 어떤 AF컨텍스트 영역을 해제하거나 재사용해야한다.

성공적인 OPEN에대해, NDIS제공 NdisAfHandle은 콜 매니저와 클라이언트가 바인딩된 특정한 닉 드라이버의 열려진 AF에대해 콜 매니저와 클라이언트 사이의 관계를 나타낸다. 두 프로토콜은 이 핸들이 요구된 파라미터인것에대한 NdisCl/Cm/CoXxx함수들에대한 순차적인 호출에서 넘겨지고, 수정되지 않고 해석되지않기위한 모호한 변수로써 NdisAfHandle을 다루어야만한다. 실패한 OPEN에대해, 콜 매니저는 NdisMCmOpenAddressFamilyComplete함수가 컨추럴을 리턴할때, NdisAfHandle가 무효하다고 간주한다.

스스로를 NDIS에게 프로토콜로써 등록하는 독립적인 콜 매니저들은 NdisCmOpenAddressFamilyComplete함수를 호출할수 있다. 통합 콜 매니지먼트를 지원하는 연결지향 닉 미니포트들은 대신 NdisMCmOpenAddressFamilyComplete함수를 호출해야만 한다.

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