ProtocolRequestComplete

VOID ProtocolRequestComplete( IN NDIS_HANDLE ProtocolBindingContext, IN PNDIS_REQUEST NdisRequest, IN NDIS_STATUS Status );

ProtocolRequstComplete 함수는 NdisRequest 함수가 NDIS_STATUS_PENDING으로 리턴된 프로토콜 초기 쿼리 혹은 설정의 처리를 완성하는 데 필요한 드라이버 함수이다.

NdisRequest 함수가 아닌 NdisCoRequest 함수를 호출하는 연결 지향 프로토콜은 ProtocolRequestComplete 함수 보다 오히려 완전히 기능적인 ProtocolCoRequestComplete 함수를 가져야 한다.

매개변수

ProtocolBindingContext

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

NdisRequest

NdisRequest 함수에 전에 전달된 프로토콜 제공 구조체를 가리킨다.

Status

아래 드라이버 혹은 NDIS에 의해 설정된 요구의 마지막 상태를 지정한다. 이 매개변수는 ProtocolRequestComplete 함수가 NdisRequest 함수에 그 정보로 어떤 일을 했는지 결정한다.

주석

ProtocolRequestComplete 함수는 다음과 같은 입력 Status 값을 사용한다:

• 만약 이 매개변수가 NDIS_STATUS_SUCCESS라면은, NDIS_REQUEST 구조체의 BytesRead 혹은 BytesWritten 멤버이면은 얼마나 많은 프로토콜 제공 정보가 설정 연산에서 NIC에게 InformationBuffer 버퍼로부터 전송되는지 혹은 쿼리 연산에 대한 응답으로 InformationBuffer 에 얼마나 많은 정보가 리턴되는지를 지정하기 위해 아래 드라이버 혹은 NDIS에 의해 설정된다.

  만약 프로토콜이 쿼리를 한다면은, ProtocolRequestComplete 함수는 Oid 멤버의 값에 의존하면서 어떤 프로토콜 결정 방법으로 InformationBuffer에 리턴된 데이터를 사용할 수 있다.

  예를 들어, 만약 프로토콜이 원래 OID_GEN_MAXIMUM_SEND_PACKET 쿼리에 초기화되어진다면은, ProtocolRequestComplete 함수는 ProtocolBindingContext 영역에 드라이버는 NdisSendPackets 함수에 대한 계속적인 호출들을 위해 드라이버가 설정할 발생하는 보내기들의 수를 막기 위해 ProtocolBindingContext 영역에 상태 변수들을 설정할 것이다.

• 만약 이러한 매개변수는 NDIS_STATUS_INVALID_LENGTH 혹은 NDIS_STATUS_BUFFER_TOO_SHORT이면은, BytesNeeded 멤버는 요구된 연산을 실행하기 위해 필요한 InformationBufferLength 의 Oid 특정 값을 지정한다.

  이러한 환경들에서, ProtocolRequestComplete 함수는 요구를 위해 충분한 버퍼 공간을 할당할 수 있고, 필요한 InformationBufferLength와 같은 Oid로 또 하나의 NDIS_REQUEST 구조체를 설정하고 NdisRequest 함수에 대한 호출을 다시 시도한다.

• 만약 이러한 매개변수는 회복할 수 없는 에러인 NDIS_STATUS_XXX 이면은, ProtocolReqeustComplete 함수는 NDIS_REQUEST 구조체를 위해 할당된 메모리를 해제해야 하고, 드라이버가 NdisReset 함수를 호출해야 하는지를 결정해야 하고, 바인딩을 닫아야 하고 혹은 바인딩시에 계속된 네트워크 I/O 연산들을 다루기 위해 바인딩 특정 상태 정보를 조정해야한다.

바인딩 특정 쿼리들에 대해, NDIS는 ProtocolRequestComplete 함수를 호출한다. NDIS 라이브러리는 모든 미니포트들을 위해 바인딩들을 유지하기 때문에, NDIS는 시스템이 필터 라이브러리를 제공하기 위한 것으로서 그들의 미디엄 타입을 보고하는 아래 드라이버에 대해 단지 바인딩 특정 정보를 리턴할 수 있다. NDIS는 다른 미니포트들에 대해 프로토콜 초기화된 바인딩 특정 쿼리들을 위해 NDIS_STATUS_NOT_SUPPORTED를 리턴한다.

시스템 정의 OID들에 대한 더 많은 정보에 대해서 Part 2를 봐라.

ProtocolRequestComplete 함수는 프로토콜이 NdisRequest 함수가 Status로 리턴하는 상태 코드를 조사할 시간을 가지기 전에 호출되어질 수 있다.

디폴트로, ProtocolReqeustComplete 함수는 arbitrary 쓰레드 컨텍스트내에서 IRQL DISPATCH_LEVEL에서 실행한다.