Solicitudes de OID del controlador de minipuerto de CoNDIS
NDIS llama a la función MiniportCoOidRequest de un controlador de miniporte CoNDIS para enviar una solicitud de OID para consultar o establecer información en el controlador. NDIS llama a MiniportCoOidRequest en su propio nombre o en nombre de un controlador excesivo que llamó a la función NdisCoOidRequest .
NDIS pasa MiniportCoOidRequest un puntero a una estructura de NDIS_OID_REQUEST que contiene la información de solicitud. La estructura de solicitud contiene un identificador OID_Xxx que indica el tipo de solicitud y otros miembros para definir los datos de la solicitud.
El miembro Timeout especifica un tiempo de espera, en segundos, para la solicitud. NDIS puede restablecer el controlador o cancelar la solicitud si el tiempo de espera expira antes de que el controlador complete la solicitud.
El miembro RequestId especifica un identificador opcional para la solicitud. Los controladores de minipuerto pueden establecer el miembro RequestId de una indicación de estado en el valor que el controlador obtuvo del miembro RequestId de una solicitud OID asociada. Normalmente, los controladores de minipuerto pueden omitir este miembro. Si un controlador debe establecer este miembro, el controlador debe usar uno de los valores necesarios, que se especifican en la página de referencia para el OID determinado. Para obtener más información sobre las indicaciones de estado, vea Indicaciones de estado del controlador de Miniport CoNDIS.
Un controlador de minipuerto puede completar una solicitud de OID de forma sincrónica devolviendo un estado correcto o de error. El controlador puede completar una solicitud de OID de forma asincrónica devolviendo NDIS_STATUS_PENDING. En este caso, el controlador debe llamar a la función NdisMCoOidRequestComplete para completar la operación.
Si la función MiniportCoOidRequest devuelve NDIS_STATUS_PENDING, NDIS puede llamar a MiniportCoOidRequest con otra solicitud para el adaptador antes de que se complete la solicitud pendiente. Debe tener en cuenta que esto es diferente de la interfaz NDIS sin conexión donde se serializan todas las solicitudes de OID.
NDIS puede llamar a la función MiniportCancelOidRequest de un controlador de miniporte para cancelar una solicitud OID de CoNDIS.