Generación de solicitudes de OID a partir de un controlador de protocolo NDIS

Para originar una solicitud de OID a los controladores subyacentes, un protocolo llama a la función NdisOidRequest .

En la ilustración siguiente se muestra una solicitud OID que se origina en un controlador de protocolo.

Después de que un controlador de protocolo invoque la función NdisOidRequest, NDIS invoca la función de solicitud del siguiente controlador subyacente. Para obtener más información sobre cómo un controlador de miniporte gestiona las solicitudes de OID, consulte las solicitudes de OID de un adaptador. Para obtener más información sobre cómo un controlador de filtro controla las solicitudes de OID, consulte Solicitudes OID del módulo de filtro.

Para completar de forma sincrónica, NdisOidRequest devuelve NDIS_STATUS_SUCCESS o un estado de error. Para completar de forma asíncrona, NdisOidRequest devuelve NDIS_STATUS_PENDING.

Si NdisOidRequest devuelve NDIS_STATUS_PENDING, NDIS llama a la función ProtocolOidRequestComplete después de que los controladores subyacentes completen la solicitud OID. En este caso, NDIS pasa los resultados de la solicitud al parámetro OidRequest de ProtocolOidRequestComplete. NDIS pasa el estado final de la solicitud al parámetro Status de ProtocolOidRequestComplete.

Si NdisOidRequest devuelve NDIS_STATUS_SUCCESS, devuelve los resultados de una solicitud de consulta en la estructura NDIS_OID_REQUEST en el parámetro OidRequest. En este caso, NDIS no llama a la función ProtocolOidRequestComplete.

Para determinar qué información se gestionó correctamente mediante un controlador subyacente, los controladores de protocolo que emiten solicitudes de OID deben comprobar el valor del miembro SupportedRevision en la estructura NDIS_OID_REQUEST una vez devuelta la solicitud OID. Para obtener más información sobre la versión de NDIS, consulte Especificación de la versión de NDIS.

Si el controlador subyacente debe asociar la solicitud OID con una indicación de estado posterior, el controlador de protocolo debe establecer el miembro RequestId en la estructura de NDIS_OID_REQUEST. Cuando el controlador subyacente realiza una indicación de estado, establece el miembro de RequestId de la estructura NDIS_STATUS_INDICATION en el valor proporcionado en la solicitud OID.

Un controlador puede llamar a NdisOidRequest cuando un enlace se encuentra en el estado Reiniciando, Ejecutando, Pausando, o Pausado.