NdisMCmOpenAddressFamilyComplete
VOID
NdisMCmOpenAddressFamilyComplete(
IN NDIS_STATUS Status,
IN NDIS_HANDLE NdisAfHandle,
IN NDIS_HANDLE CallMgrAfContext
);
|
NdisMCmOpenAddressFamilyComplete함수는 MCM드라이버의 어드레스 패밀리를 열기위해 MDM드라이버의 ProtocolCmOpenAf함수가 NDIS_STATUS_PENDING을 리턴한것에대한 클라이언트 요청의 최종 상태를 리턴한다.
매개변수
- Status
- AF를 열기위한 클라이언트 요청의 최종 상태를 지정한다. NDIS_STATUS_SUCCESS혹은 NDIS_STATUS_PENDING를 제외한 호출자 의존 NDIS_STATUS_XXX.
- NdisAfHandle
- NDIS_STATUS_PENDING을 리턴한 MCM드라이버의 ProtocolCmOpenAf함수의 입력파라미터인 NDIS제공 핸들을 지정한다.
- CallMgrAfContext
- 만약 오픈이 성공이면 NdisAfHandle을 포함하는 MCM미니포트가 클라이언트의 어드레스 패밀리 오픈에대한 상태를 유지하는 호출자 할당 상주 컨텍스트 영역에대한 핸들을 지정한다. 그렇지 않으면, NDIS는 이 파라미터를 무시한다.
주석
MCM미니포트는 만약 ProtocolCmOpenAf함수가 이전에 주어진 NdisAfHandle에대해 NDIS_STATUS_PENDING을 리턴한다면, NdisMCmOpenAddressFamilyComplete함수를 호출해야만 한다. NdisClOpenAddressFamily함수에대한 호출로 지연된 오픈-AF연산을 초기화하는 클라이언트는 같ㅇ느 바인딩에대해 NdisMCmOpenAddressFamilyComplete함수가 클라이언트의 ProtocolClOpenAfComplete함수를 호출하도록 할때까지 더이상의 연결지향 연산들을 수행할수 없다.
만약 NdisMCmOpenAddressFamilyComplete함수의 호출이 Status를 NDIS_STATUS_SUCCESS로 설정한다면, NDIS는 순차적으로 입력파라미터로써 클라이언트가 AF를 닫을때까지 클라이언트의 어드레스 패밀리 오픈을 고려하는 주어진 CallMgrAfContext핸들을 모든 MCM드라이버 제공 ProtocolCmXxx 와 ProtocolCoXxx함수에게 넘긴다. MCM드라이버는 NdisMCmOpenAddressFamilyComplete함수에게 실패 상태를 넘기기전에 할당된 AF컨텍스트 영역을 해제하거나 재사용 해야한다.
성공적인 열기에대해, NDIS제공 NdisAfHandle은 열려진 AF에대해 MCM드라이버와 클라이언트사이의 연관을 나타낸다. 두 NDIS드라이버는 이 핸들이 요구되는 파라미터인것에대해 NdisCl/Co/MCm/MCoXxx함수들에대한 순차적인 호출에서 넘겨지고 수정되지않고 해석되지않는 모호한 변수로써 NdisAfHandle핸들을 다루어야만 한다. 실패한 오픈에대해, MCM미니포트는 NdisMCmOpenAddressFamilyComplete함수가 컨추럴을 리턴할때 NdisAfHandle을 무효한것으로 간주해야한다.
통합 콜 매니지먼트를 제공하는 연결지향 닉 미니포트만이 NdisMCmOpenAddressFamilyComplete함수를 호출할수 있다. 스스로를 NDIS에게 프로토콜로써 등록하는 독립적인 매니저는 대신 NdisCmOpenAddressFamilyComplete함수를 호출한다.
NdisMCmOpenAddressFamilyComplete함수의 호출은 IRQL <= DISPATCH_LEVEL에서 동작될수 있다.
|