Solicitudes de OID para el controlador miniport de CoNDIS

NDIS llama a la función MiniportCoOidRequest de un controlador miniport CoNDIS para enviar una solicitud OID para consultar o establecer información en el controlador. NDIS llama a MiniportCoOidRequest por sí mismo o en nombre de un controlador superior 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 solicitud.

El miembro Timeout especifica un tiempo de espera, en segundos, para la solicitud. NDIS puede restablecer el controlador o cancelar la solicitud si expira el tiempo de espera antes de que el controlador complete la solicitud.

El miembro RequestId especifica un identificador opcional para la solicitud. Los controladores de miniport 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 miniport pueden ignorar este componente. 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 miniportar CoNDIS.

Un controlador de miniport puede completar una solicitud OID de forma sincrónica devolviendo un estado correcto o de error. El controlador puede completar una solicitud 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 OID.

NDIS puede llamar a la función MiniportCancelOidRequest de un controlador de miniporte para cancelar una solicitud OID de CoNDIS.