NdisCoRequest

NDIS_STATUS NdisCoRequest( IN NDIS_HANDLE NdisBindingHandle, IN NDIS_HANDLE NdisAfHandle OPTIONAL, IN NDIS_HANDLE NdisVcHandle OPTIONAL, IN NDIS_HANDLE NdisPartyHandle OPTIONAL, IN OUT PNDIS_REQUEST NdisRequest );

NdisCoRequest함수는 OID_GEN_CO_XXX혹은 클라이언트로 부터 독립적인 콜 매니저 혹은 vice versa까지 그리고 클라이언트 혹은 콜 매니저로부터 하위 닉 미니포트 드라이버까지 연결 지향 미디엄-지정 OID_XXX요청을 실행한다.

매개변수

NdisBindingHandle

타겟 닉 혹은 호출자가 바인딩된 다음 하위 드라이버의 가상 닉을 확인하는 NdisOpenAdapter함수에의해 리턴된 핸들을 지정한다.

NdisAfHandle

이것은 클라이언트, 콜 매니저,그리고 NDIS사이에 공유되어지는 오픈 어드레스 패밀리를 확인하는 핸들을 지정한다.

• 만약 호출자가 콜 매니저로 하여금 요청을 만들도록 하는 클라이언트라면, 클라이언트는 원래 NdisClOpenAddressFamily함수에대한 성공적인 호출로부터 이핸들을 얻는다.
• 만약 호출자가 클라이언트에대한 요청을 만드는 독립적인 콜 매니저이면, CM은 처음에 ProtocolCmOpenAf함수에대한 입력 파라미터로써 이 핸들을 얻는다.

NdisVcHandle

만약 요청이 VC지정이면 호출자가 정보를 요청하거나 설정하고 있는것에대한 VC를 확인하는 핸들을 지정한다. 그렇지 않으면 NULL이다. VC지정 요청에대해, 콜 매니저는 처음에 NdisCoCreateVc함수로 VC를 만들때나 혹은 ProtocolCoCreateVc함수에대한 입력 파라미터로써 이핸들을 얻는다. 하위 닉 미니포트에게 디렉트되는 VC지정 요청에대해 이핸들은 VC를 확인한다. NdisAfHandle과 NdisPartyHandle이 NULL인 동안.

NdisPartyHandle

만약 요청이 파티 지정이면 호출자가 요청하거나 설정하는 것에대한 멀티포인트VC에대한 파티를 확인하기위한 핸들을 지정한다. 그렇지 않으면, 이 파라미터는 NULL이다. 어떤 파티 지정 요청에대해, 클라이언트는 처음에 NdisClAddParty 혹은NdisClMakeCall함수로터 이 핸들을 얻고, 콜 매니저는 이 핸들을 ProtocolCmAddParty함수에대한 입력 파라미터로써 얻는다. 만약 NdisAfHandle이 NULL이면, 이 파라미터 또한 NULL이다.

NdisRequest

호출자에의해 설정되고 NDIS_REQUEST타입의 구조체로 형식화된 호출자 제공 상주 버퍼의 포인터.

리턴값

NdisCoRequest함수가 NDIS_STATUS_PENDING이외의 것을 리턴할때, 호출자는 ProtocolCl/CmRequestComplete함수에대한 내부적인 호출을 만들어야 한다. 그렇지 않으면, NDIS는 드라이버의 ProtocolCl/CmRequestComplete함수를 이연산이 끝날때 호출한다.

주석

NdisCoRequest함수를 호출하기전에, 프로토콜은 요청에대한 버퍼를 할당하고 NDIS_REQUEST구조체를 초기화 한다. 그런 드라이버는 콜 매니저혹은 클라이언트와의 통신때, 시스템 정의 OID_GEN_CO_XXX코드로 NDIS_REQUEST구조체의 Oid멤버를 설정한다. 하위 닉 미니포트 다이렉트된 요청에대해, 프로토콜은 Oid멤버를 OID_GEN_CO_XXX혹은 NdisCoRequest함수의 호출때 OID_ATM_ALIGNMENT_REQUIRED처럼 미디엄 지정 OID_XXX코드를 설정할수 있다.

NdisAfHandle의 값에 의존하여, 클라이언트와 독립적인 콜매니저들은 각각 혹은 하위 연결지향 닉 미니포트와 통신하기위해 NdisCoRequest함수를 호출한다.

NdisVcHandle에 NULL을 넘기는것은 요청이 클라이언트, 콜 매니저 혹은 미니포트에게 다이렉트되는지 실제로 그런 요청을 만든다. 예를들어, 하위 연결지향 닉 미니포트에게 OID_GEN_CO_RCV_CRC_ERROR요청은 만약 호출자가 확실한 NdisVcHandle를 제공한다면, 미니포트가 특정한 VC에 인디케이트된 모든 수신에서 마주친 CRC에러들의 수를 리턴한다.

클라이언트와 독립적인 콜 매니저들은 프로토콜이 하위 닉 드라이버에대해 바인딩된후 초기화동안에 OID_GEN_SUPPORTED_LIST쿼리에대해 리턴된것처럼 연결지향이 아닌 모든 OID들로 NdisRequest함수를 호출해야만 한다.

NdisCoRequest와 NdisRequest함수를 사용하는것에대해 정의된 OID들의 설정에대한 더많은 정보는 이 매뉴얼의 Part 2를 보아라.

단지 스스로를 NDIS로 프로토콜로써 등록하는 콜 매니저와 클라이언트만이 NdisCoRequest함수를 호출할수 있다. 통합 콜 매니지먼트를 지원하는 연결지향 닉 미니포트는 그들의 클라이언트와 통신하기위해 대신 NdisMCmRequest함수를 호출한다.

NdisCoRequest함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작되어질수 있다.