MiniportCoRequest

NDIS_STATUS MiniportCoRequest( IN NDIS_HANDLE MiniportAdapterContext, IN NDIS_HANDLE MiniportVcContext OPTIONAL, IN OUT PNDIS_REQUEST NdisRequest );

MiniportCoRequest는 연결 지향 미니포트들을 위한 요구된 함수이다. MiniportCoRequest는 미니포트로부터 정보를 얻고 혹은 설정하기 위해 프로토콜 초기 요구들을 다룬다.

매개변수

MiniportAdapterContext

미니포트가 어댑터의 이 인스턴스에 대하여 상태 정보를 유지하는 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정한다. 미니포트는 MiniportInitialize 함수로부터 NdisMSetAttributesEx를 호출함으로써 NDIS에 대한 이 핸들을 제공한다.

MiniportVcContext

미니포트가 VC당 상태를 유지하는 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정한다. 미니포트는 MiniportCoCreateVc 함수로부터 NDIS에 대한 이러한 핸들을 제공한다.

NdisRequest

핸들에 대해 미니포트를 위하여 요구 패킷과 버퍼를 포함하는 NDIS_REQUEST를 가리킨다. 요구에 의존하여, 미니포트는 제공된 구조체에서 요구된 정보를 리턴한다.

리턴값

NDIS_STATUS_SUCCESS

미니포트는 요구된 것처럼 데이터를 얻고 설정하는 것을 가리킨다.

NDIS_STATUS_PENDING

미니포트는 비동기적으로 요구를 완성시키는 것을 가리킨다. 일단 미니포트가 모든 처리를 완성한다면은 요구가 완성된 것을 NDIS에게 신호를 보내기 위해 NdisMCoRequestComplete를 호출해야 한다.

NDIS_STATUS_INVALID_OID

NdisRequest에서 지정된 요구는 유효하지 않고 혹은 인식되지 않은 것을 가리킨다.

NDIS_STATUS_INVALID_SUPPORTED

NdisRequest에서 지정된 요구는 인식되지만은 미니포트에 의해 지원되지 않는다.

NDIS_STATUS_INVALID_LENGTH

NdisRequest에서 공급된 버퍼는 요구된 데이터를 유지하기 위해 충분하지 않는 크기라는 것을 가리킨다.

NDIS_STATUS_DATA

NdisRequest에서 요구를 위해 지정된 하나나 혹은 그 이상의 매개변수들은 유효하지 않다는 것을 가리킨다.

주석

NDIS는 NdisCoRequest를 호출하는 바운드된 프로토콜 드라이버를 위해 혹은 자기 자신을 위해 MiniportCoRequest 함수를 호출한다. 미니포트 드라이버들은 NdisRequest에서 제공된 요구를 조사해야 하고 요구된 행동을 한다. 연결 지향 미니포트 드라이버들이 다뤄야 하는 요구된 그리고 선택적인 OID_GEN_CO_XXX에 대한 더 많은 정보에 대해서는 Part 2를 봐라.

MiniportCoRequest는 IRQL DISPATCH_LEVEL로부터 실행할 수 있는 것 처럼 쓰여져야 한다.