ProtocolCoRequstComplete
VOID
ProtocolCoRequestComplete(
IN NDIS_STATUS Status,
IN NDIS_HANDLE ProtocolAfContext OPTIONAL,
IN NDIS_HANDLE ProtocolVcContext OPTIONAL,
IN NDIS_HANDLE ProtocolPartyContext OPTIONAL,
IN OUT PNDIS_REQUEST NdisRequest
);
|
ProtocolCoRequestComplete 함수는 NdisMCmRequest 함수에 대한 MCM 드라이버의 호출의 혹은 NdisCoRequest 함수에 대한 연결 지향 클라이언트의 혹은 혼자인 콜 매니저의 호출에 대한 결과들을 후처리하는 요구된 함수이다.
매개변수
- Status
- 이러한 요구를 다루는 응답하는 클라이언트 혹은 콜 매니저에 의해 설정된 NDIS_STATUS_SUCCESS 혹은 실패 NDIS_STATUS_XXX로 드라이버 초기화된 요구의 마지막 상태를 지정한다. 이 매개변수를 결코 NDIS_STATUS_PENDING이 아니다.
- ProtocolAfContext
- 드라이버의 AF당 컨텍스트 영역에 대한 핸들을 지정한다. 클라이언트는 콜 매니저에게 연결하기 위해 NdisClOpenAddressFamily 함수를 호출할 때 이 핸들을 제공한다. 콜 매니저는 ProtocolCmOpenAf 함수로부터 이 핸들을 제공하고 이 핸들은 효율적으로 이요구가 지시되는 특정 클라이언트를 지정한다.
- ProtocolVcContext
- 클라이언트 혹은 콜 매니저는 만약 요구가 VC 특정이면 정보를 요구하거나 설정하는 멀티포인트 VC에 대한 party를 지정하는 핸들을 지정한다. 그렇지 않으면, 이 매개변수는 NULL이다.
- NdisRequest
- 드라이버가 선행 NdisCoRequest 혹은 NdisMCmRequest 함수에 대한 호출에서 전달한 NDIS_REQUEST 구조체로 포맷화된 드라이버 할당 버퍼를 가리킨다. NDIS_REQUEST 구조체의 Oid 멤버는 응답하는 클라이언트 혹은 콜 매니저가 쿼리를 위한 요구된 정보를 리턴하거나 만약 Status가 NDIS_STATUS_SUCCESS이면 설정을 위한 주어진 정보를 전달하는 버퍼로 요구된 쿼리 혹은 설정 연산을 지정하는 시스템 정의 OID_GEN_CO_XXX 코드를 포함한다.
주석
ProtocolCoRequestComplete 함수는 입력 Status를 다음과 같은 값을 사용할 수 있다.
- 만약 이러한 매개변수가 NDIS_STATUS_SUCCESS이면, NDIS_REQUEST 구조체의 BytesRead 혹은 BytesWritten 멤버는 얼마나 많은 데이터가 InformationBuffer 버퍼로 전송되어지는지를 지정하기 위해 설정된다.
만약 주어진 OID_GEN_CO_XXX가 쿼리이면, ProtocolCoRequestComplete 함수는 Oid멤버의 값에 의존하는 어떤 드라이버 결정 방법으로 InformationBuffer에 리턴되는 데이터를 사용할 수 있다.
ProtocolCoRequestComplete 함수는 드라이버가 이러한 요구의 후처리를 완성할 때 NdisRequest 드라이버 할당 버퍼들과 InformationBuffer를 해제할 책임이 있다.
- 만약 이러한 매개변수가 NDIS_STATUS_INVALID_LENGTH 혹은 NDIS_STATUS_BUFFER_TOO_SHORT이면, BytesNeeded 멤버는 요구된 연산을 실행하기 위해 필요한 InformationBufferLength의 Oid 특정 값을 지정한다.
이러한 환경들에서, ProtocolCoRequestComplete 함수는 요구를 위한 충분한 버퍼 공간을 할당할 수 있고, 요구된 InformationBufferLength와 같은 Oid 값으로 또 하나의 NDIS_REQUEST 구조체를 설정하고 NdisCoRequest 혹은 NdisMCmRequest 함수에 대한 호출을 재시도한다.
- 만약 이러한 매개변수가 회복할 수 없는 에러를 가리키는 NDIS_STATUS_XXX이면, ProtocolCoRequestComplete 함수는 NdisRequest 버퍼를 해제해야 하고 필요한 어떤 드라이버 결정 연산들을 실행해야 한다. 예를 들어, ProtocolCoRequestComplete 함수는 만약 리턴된 에러 상태가 드라이버가 가상 연결에서 계속해서 전송할 수 없다는 것을 가리킨다면 드라이버가 만든 VC를 끊어야 한다.
심지어 NdisCoRequest 혹은 NdisMCmRequest 함수에 대한 드라이버 호출이 NDIS_STATUS_PENDING외에 어떤 것을 리턴한다면, 그러한 드라이버는 완성된 요구들을 후처리하기 위해 ProtocolCoRequestComplete 함수를 사용해야 한다. NdisCoRequest 혹은 NdisMCmRequest 함수로부터 리턴되자 마자 드라이버의 자신의 ProtocolCoRequestComplete 함수에 대한 내부 호출을 하는 것은 드라이버의 퍼포먼스의 역 영향을 주지 않고 드라이버의 이미지를 더 작게 만들고 그러한 드라이버는 드라이버 초기화된 요구들을 체킹하는 상태 리턴를 하는 코드를 복제하지 않기 때문에 하나의 OS 배포에서 다음 배포를 유지하는 것을 더 쉽게 한다.
NdisCoRequest 그리고 NdisMCmRequest 함수로 사용을 위해 정의된 OID들의 설정에 대한 더 많은 정보는 이 매뉴얼의 Part 2를 봐라.
ProtocolCoRequestComplete 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.
|