Solicitações CoNDIS MCM OID

Como outros gerenciadores de chamadas CoNDIS, os gerenciadores de chamadas de miniporta (MCMs) podem consultar ou definir os parâmetros operacionais dos drivers de cliente CoNDIS. Os drivers de cliente CoNDIS podem consultar ou definir os parâmetros do gerenciador de chamadas ou os parâmetros do driver de miniporta de um MCM.

Para originar uma solicitação OID para um driver de cliente CoNDIS, um MCM chama a função NdisMCmOidRequest .

A figura a seguir ilustra uma solicitação OID originada por um MCM.

Depois que um driver MCM chama a função NdisMCmOidRequest , o NDIS chama a função ProtocolCoOidRequest do driver do cliente.

Para concluir de forma síncrona, NdisMCmOidRequest retorna NDIS_STATUS_SUCCESS ou um status de erro. Para concluir de forma assíncrona, NdisMCmOidRequest retorna NDIS_STATUS_PENDING.

Se NdisMCmOidRequest retornar NDIS_STATUS_PENDING, o NDIS chamará a função ProtocolCoOidRequestComplete do MCM após os controladores do cliente concluírem a solicitação de OID chamando a função NdisCoOidRequestComplete. Nesse caso, o NDIS transfere os resultados do pedido para o parâmetro OidRequest de ProtocolCoOidRequestComplete. O NDIS passa o status final da solicitação no parâmetro Status de ProtocolCoOidRequestComplete.

Se NdisMCmOidRequest retornar NDIS_STATUS_SUCCESS, ele retornará os resultados de uma solicitação de consulta na estrutura NDIS_OID_REQUEST no parâmetro OidRequest . Nesse caso, o NDIS não chama a função ProtocolCoOidRequestComplete do MCM.

Os drivers de cliente CoNDIS podem consultar ou definir os parâmetros operacionais do gerenciador de chamadas ou os parâmetros operacionais de miniporta dos MCMs. Para originar uma solicitação OID para parâmetros do gerenciador de chamadas MCM, um cliente chama a função NdisCoOidRequest e fornece um identificador de família de endereços (AF) válido no parâmetro NdisAfHandle . Para originar uma solicitação OID para parâmetros de miniporta MCM, um cliente chama a função NdisCoOidRequest e define o identificador AF como NULL.

Depois que um cliente chama a função NdisCoOidRequest , o NDIS chama a função MiniportCoOidRequest ou a função ProtocolCoOidRequest do driver MCM.

A figura a seguir ilustra uma solicitação OID para os parâmetros de miniporta do MCM.

A figura a seguir ilustra uma solicitação OID para os parâmetros do gerenciador de chamadas do MCM.

Para concluir de forma síncrona, NdisCoOidRequest retorna NDIS_STATUS_SUCCESS ou um status de erro. Para concluir de forma assíncrona, ProtocolCoOidRequest ou MiniportCoOidRequest retorna NDIS_STATUS_PENDING.

Se ProtocolCoOidRequest ou MiniportCoOidRequest retornar NDIS_STATUS_PENDING, o NDIS chamará a função ProtocolCoOidRequestComplete do cliente depois que o MCM concluir a solicitação OID chamando a função NdisMCoOidRequestComplete ou NdisMCmOidRequestComplete. Nesse caso, o NDIS transfere os resultados do pedido para o parâmetro OidRequest de ProtocolCoOidRequestComplete. O NDIS passa o status final da solicitação no parâmetro Status de ProtocolCoOidRequestComplete.

Se NdisCoOidRequest retornar NDIS_STATUS_SUCCESS, ele retornará os resultados de uma solicitação de consulta na estrutura NDIS_OID_REQUEST no parâmetro OidRequest . Nesse caso, o NDIS não chama a função ProtocolCoOidRequestComplete do cliente.