ProtocolCoRequest
NDIS_STATUS
ProtocolCoRequest(
IN NDIS_HANDLE ProtocolAfContext,
IN NDIS_HANDLE ProtocolVcContext OPTIONAL,
IN NDIS_HANDLE ProtocolPartyContext OPTIONAL,
IN OUT PNDIS_REQUEST NdisRequest
);
|
ProtocolCoRequest 함수는 응답하는 클라이언트들 혼자의 콜 매니저로부터 NdisCoRequest 함수에 대한 호출에 의해 초기화되거나 혹은 NdisMCmRequest 함수에 대한 MCM 드라이버의 호출들에 의해 초기화된 OID_CO_XXX 요구들을 다루는 필요한 함수이다.
매개변수
- ProtocolAfContext
- 드라이버의 AF당 컨텍스트 영역에 대한 핸들을 지정한다. 클라이언트는 콜 매니저에 연결하기 위해 NdisClOpenAddressFamily 함수를 호출할 때 이 핸들을 제공한다. 콜 매니저는 ProtocolCmOpenAf 함수로부터 이 핸들을 제공하고 그래서 이 핸들은 효율적으로 이 요구를 발생한 특정 클라이언트를 가리킨다.
- ProtocolVcContext
- 클라이언트 혹은 콜 매니저가 만약 요구가 VC 특정이라면 정보를 요구하거나 혹은 설정하기 위한 활성화된 VC를 지정하는 핸들을 지정한다. 그렇지 않으면, 이러한 매개변수는 NULL이다.
- ProtocolPartyContext
- 클라이언트 혹은 콜 매니저가 만약 요구가 party 특정이면 정보를 요구하거나 혹은 설정하기 위해 멀티 포인트 VC에 party를 지정하는 핸들을 지정한다. 그렇지 않으면, 이 매개변수는 NULL이다.
- NdisRequest
- ProtocolCoRequest 함수에 의해 실행되어지는 연산을 지정하는 NDIS_REQUEST 구조체로 포맷화된 버퍼를 가리킨다. NDIS_REQUEST 구조체의 Oid 멤버는 프로토콜이 쿼리를 위한 요구된 정보를 리턴하는 혹은 설정을 위한 주어진 정보를 전송하는 버퍼로 요구된 쿼리 혹은 설정 연산을 지정하는 시스템 정의 OID_GEN_CO_XXX 코드를 포함한다.
리턴값
ProtocolCoRequest 함수는 다음과 같은 하나를 리턴한다.
- NDIS_STATUS_SUCCESS
- 클라이언트 혹은 콜 매니저는 요구된 연산을 실행한다.
- NDIS_STATUS_PENDING
- 클라이언트 혹은 콜 매니저는 비동기적으로 이러한 요구를 다루고 요구된 연산이 행해졌을 때 NdisCoRequestComplete 함수(혹은 통합된 콜 관리를 지원하는 NIC 미니포트는 NdisMCmRequestComplete 함수)를 호출할 것이다.
- NDIS_STATUS_INVALID_LENGTH 혹은 NDIS_STATUS_BUFFER_TOO_SHORT
- 드라이버는 NdisCoRequest 혹은 NdisMCmRequest 함수의 호출자가 주어진 요구를 우한 적당한 InformationBuffer를 제공하지 않기 때문에 이러한 요구는 실패한다. 드라이버는 요구된 연산을 실행하기위해 요구된 InformationBufferLength의 Oid 특정 값으로 NdisRequest인 버퍼에 BytesNeeded 멤버를 설정한다.
- NDIS_STATUS_XXX
- 클라이언트는 혹은 콜 매니저는 설정을 위해 지정된 유효하지 않은 입력 데이터처럼 몇몇 드라이버 결정 이유를 위한 요구를 실패한다.
- NDIS_STATUS_NOT_SUPPORTED
- 클라이언트 혹은 콜 매니저는 NdisRequest인 버퍼내에 Oid 멤버내에 OID_GEN_CO_XXX 코드를 인식하지 못하기 때문에 이러한 요구를 실패한다.
주석
연결 지향 클라이언트들과 혼자의 콜 매니저들은 그들이 NdisCoRequest 함수를 호출할 때 외연적인 NdisAfHandle를 지정함으로써 서로 정보를 통신한다. 유사하게, 통합된 콜 관리 지원을 가진 연결 지향 미니포트는 각각의 클라이언트들로 정보를 통신하기 위해 외연적인 NdisAfHandles로 NdisMCmRequest 함수를 호출한다. 외연적인 NdisAfHandle을 가진 NdisCoRequest 혹은 NdisMCmReqeust 함수에 대한 호출은 NDIS에게 주어진 NdisAfHandle를 공유하는 클라이언트, 혼자의 콜 매니저 혹은 MCM 드라이버의 ProtocolCoRequest 함수를 호출하도록 한다.
만약 입력 NdisVcHandle과 NdisPartyHandle이 NULL이면, ProtocolCoRequest 함수는 원래 요구가 global로 여겨질 수 있다. 예로 ProtocolCoRequest 함수는 주어진 주소 패밀리에서 어떤 활성화한 멀티포인트 VC들을 포함하는 모든 현재 활성화 VC들에 대한 정보를 리턴함으로써 외연적인 NdisAfHandle을 전달하기 위한 어떤 OID_GEN_CO_XXX 쿼리를 만족한다.
외연적인 NdisVcHandle 혹은 NdisPartyHandle은 ProtocolCoRequest 함수는 각각 VC당 혹은 Party 토대로 주어진 요구를 만족해야 한다.
ProtocolCoRequest 함수는 NdisRequest인 버퍼가 비페이지화된 pool로부터 할당되고 상승된 IRQL에서 접근할 수 있다고 추측될 수 있다. NdisCoRequest(혹은 NdisMCmRequest) 함수의 호출자는 요구가 완성될 때 할당한 InformationBuffer인 내부 버퍼와 이러한 버퍼를 해제하기 위해 책임질 수 있다.
만약 ProtocolCoRequest 함수가 NDIS_STATUS_PENDING을 리턴한다면, 드라이버는 주어진 요구를 만족하는 연산들을 완성할 때 NdisCoRequestComplete 함수 혹은 MCM 드라이버를 위해 NdisMCmRequestComplete 함수를에 대한 계속적인 호출을 해야 한다.
NdisCoRequest, NdisMCmRequest, NdisRequest로 사용하는 OID들의 설정에 대한 더 자세한 정보를 위해 이 매뉴얼의 Part 2를 봐라.
ProtocolCoRequest 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.
|