ProtocolOpenAdapterComplete

VOID ProtocolOpenAdapterComplete( IN NDIS_HANDLE ProtocolBindingContext, IN NDIS_STATUS Status, IN NDIS_STATUS OpenErrorStatus );

ProtocolOpenAdapterComplete함수는 NdisOpenAdapter함수가 NDIS_STATUS_PENDING을 리터했던것에 대한 바인딩연산의 처리를 완결하는 필수 드라이버 함수이다.

매개변수

ProtocolBindingContext

프로토콜이 바인딩 당 런타임 상태를 유지하는 프로토콜 할당 컨텍스트 영역을 명시한다. NdisOpenAdapter함수가 호출됐을 때 드라이버가 이 핸들을 제공 했다.

Status

NIC드라이버 열기 연산의 마지막 상태를 명시 한다. 바인딩이 확립됐으면 NDIS_STATUS_SUCCESS이거나 다래단의 드라이버에의 에러 상태가 결정됐다.

아랫단 NIc드라이버는 열기 연산이 팬딩인 동안 받은 어떤 요구에 대해서도 NDIS_STATUS_ADAPTER_NOT_READY를 리턴한다.ProtocolOpenAdapterComplete 함수가 제어를 리턴한 후에, 라래단 드라이버는 이샹태를 리턴할 수 없다.

OpenErrorStatus

만약 상태 값이 NDIS_STATUS_SUCCESS이 아니고 아래단 드라이버가 이 정보를 제공하면 이 failure의 원인에 대한 추가정보를 리턴한다. 토큰 링의 NIC드라이버는 NDIS가 ProtocolOpenAdapterComplete함수로 포워드하는 링 에러를 리턴한다. 이 파라미터는 NULL이 될 수 없다.

주석

NdisOpenAdapter 함수가 NDOS 프로토콜 드라이버의 ProtocolBindAdapter 함수를 위해 NDIS_STATUS_PENDING을 리턴할 때, NDIS는 동기적은 바인딩 연산이 완결 됐을 때 드라이버의 ProtocolOpenAdapterComplete 함수를 호출한다.

들어온 상태가 NDIS_STATUS_SUCCESS이면, ProtocolOpenAdapterComplete 함수는 드라이버 결정의 바인딩 당 연산이 어떻든지 ProtocolBindAdapter함수는 비동기적 바인딩 연산을 실행한 것을 carries out한다.다음, ProtocolOpenAdapterComplete 함수는 ProtocolBindAdapter 함수에 의한 ProtocolBindingContext 에서 상태와 OpenStatus 인자와 BindContext 핸들을 함께 저장하기 위해 NDIS_STATUS_SUCCESS와 함께 NdisCompleteBindAdapter 함수를 호출한다. 그리고나서,ProtocolOpenAdapterComplete ㅎ마수는 제어를 리턴한다.

다시말해서, ProtocolOpenAdapterComplete 함수는 ProtocolBindAdapter함수에 의해 이미 셋업된 모든 바인딩 당 상태를 클린업한다. BindContext핸들ㅇ르 제외한 ProtocolBindAdapter 함수에 의한 모든 상태 셋없을 해제하는 것 후, 제어를 리턴하기 전에 상태와 핸들에 대한 에러와 함께 NdisCompleteBindAdapter 함수를 호출한다.

디폴트로, ProtocolOpenAdapterComplete 함수는 시스템 쓰레드의 컨텍스트 안에서 IRQL PASSIVE_LEVEL에서 실행한다.