Compartir a través de

Trabajo con GUID_DEVICE_RESET_INTERFACE_STANDARD

La interfaz GUID_DEVICE_RESET_INTERFACE_STANDARD define una manera estándar de que los controladores de función intenten restablecer y recuperar un dispositivo que no funciona correctamente.

Hay dos tipos de restablecimientos de dispositivo disponibles a través de esta interfaz:

  • Restablecimiento del dispositivo a nivel de función. En este caso, la operación de restablecimiento está restringida a un dispositivo específico y no es visible para otros dispositivos. El dispositivo permanece conectado al bus a lo largo del restablecimiento y vuelve a un estado válido (estado inicial) después del restablecimiento. Este tipo de restablecimiento tiene el menor impacto en el sistema.

  • Este tipo de restablecimiento puede ser implementado ya sea por el controlador de bus o por el firmware ACPI. El controlador de bus puede implementar un restablecimiento de nivel de función si la especificación del bus define un mecanismo de restablecimiento en banda que cumple el requisito. El firmware ACPI puede invalidar opcionalmente un restablecimiento de nivel de función definido por el controlador de bus con su propia implementación.

  • Restablecimiento a nivel de plataforma del dispositivo. En este caso, la operación de restablecimiento hace que el dispositivo se notifique como que falta en el bus. La operación de restablecimiento afecta a un dispositivo específico y a todos los demás dispositivos conectados a él a través de la misma línea de restablecimiento o riel de alimentación. Este tipo de restablecimiento tiene el mayor impacto en el sistema. El sistema operativo desmonta y reconstruye las pilas de todos los dispositivos afectados para garantizar el reinicio desde un estado en blanco.

A partir de Windows 10, estas entradas del Registro bajo la HKLM\SYSTEM\CurrentControlSet\Control\Pnp clave configuran la operación de restablecimiento:

  • DeviceResetRetryInterval: período de tiempo antes de que se inicie la operación de restablecimiento. El valor predeterminado es de 3 segundos. El valor mínimo es de 100 milisegundos; el valor máximo es de 30 segundos.

  • DeviceResetMaximumRetries: número de intentos para realizar la operación de restablecimiento.

Nota:

La interfaz GUID_DEVICE_RESET_INTERFACE_STANDARD está disponible a partir de Windows 10.

Uso de la interfaz de restablecimiento de dispositivo

Si un controlador de función detecta que el dispositivo no funciona correctamente, primero debe intentar un restablecimiento de nivel de función. Si un restablecimiento de nivel de función no corrige el problema, el controlador puede optar por intentar un restablecimiento de nivel de plataforma. Sin embargo, un restablecimiento de nivel de plataforma solo debe usarse como opción final.

Para consultar esta interfaz, un controlador de dispositivo envía una IRP_MN_QUERY_INTERFACE IRP a la pila de controladores. Para este IRP, el controlador establece el parámetro de entrada InterfaceType en GUID_DEVICE_RESET_INTERFACE_STANDARD. En caso de que el IRP se complete exitosamente, el parámetro de salida de la interfaz es un puntero a una estructura de tipo DEVICE_RESET_INTERFACE_STANDARD. Esta estructura contiene un puntero a la rutina DeviceReset, que se puede usar para solicitar un restablecimiento de nivel de función o de nivel de plataforma.

Compatibilidad con la interfaz de restablecimiento de dispositivos en los controladores de función

Para admitir la interfaz de restablecimiento de dispositivo, la pila de dispositivos debe cumplir los siguientes requisitos.

El controlador de funciones debe gestionar correctamente IRP_MN_QUERY_REMOVE_DEVICE, IRP_MN_REMOVE_DEVICE y IRP_MN_SURPRISE_REMOVAL.

En la mayoría de los casos, cuando el controlador recibe IRP_MN_QUERY_REMOVE_DEVICE, debe indicar éxito para que el dispositivo se pueda quitar sin problemas. Sin embargo, puede haber casos en los que el dispositivo no se pueda detener de forma segura, como si el dispositivo está bloqueado en un bucle de escritura en un búfer de memoria. En tales casos, el controlador debe devolver STATUS_DEVICE_HUNG a IRP_MN_QUERY_REMOVE_DEVICE. El administrador de PnP continúa el proceso de IRP_MN_QUERY_REMOVE_DEVICE y IRP_MN_REMOVE_DEVICE, pero esa pila determinada no recibirá IRP_MN_REMOVE_DEVICE. En su lugar, la pila de dispositivos recibirá IRP_MN_SURPRISE_REMOVAL después de restablecer el dispositivo.

Para obtener más información sobre estos IRP, consulte:

Control de una solicitud de IRP_MN_QUERY_REMOVE_DEVICE

Control de una solicitud de IRP_MN_REMOVE_DEVICE

Control de una solicitud de IRP_MN_SURPRISE_REMOVAL

Compatibilidad con la interfaz de restablecimiento de dispositivos en controladores de filtro

Los controladores de filtro pueden interceptar IRP_MN_QUERY_INTERFACE IRP que tienen el tipo de interfaz GUID_DEVICE_RESET_INTERFACE_STANDARD. Al hacerlo, pueden seguir delegando en la interfaz GUID_DEVICE_RESET_INTERFACE_STANDARD, pero realizar operaciones específicas del dispositivo antes o después de la operación de restablecimiento. Como alternativa, pueden invalidar la interfaz GUID_DEVICE_RESET_INTERFACE_STANDARD devuelta por el controlador de bus con su propia interfaz para proporcionar su propia operación de restablecimiento.

Compatibilidad con la interfaz de restablecimiento de dispositivos en controladores de bus

Los controladores de bus que participan en el proceso de restablecimiento del dispositivo (es decir, los controladores de autobús asociados al dispositivo que solicita el restablecimiento y los controladores de autobús asociados a los dispositivos que responden a la solicitud de restablecimiento) deben cumplir uno de los siguientes requisitos:

  • Ser compatible con enchufes calientes. El controlador de bus debe ser capaz de detectar tanto cuando un dispositivo se quita del bus sin previo aviso como cuando se conecta al bus.

  • Como alternativa, debe implementar la interfaz GUID_REENUMERATE_SELF_INTERFACE_STANDARD. Esto simula que un dispositivo se extrae de un bus y se conecta de nuevo. Los controladores de bus integrados (como PCI y SDBUS) admiten esta interfaz. Por lo tanto, si el dispositivo que se restablece utiliza uno de estos autobuses, no debería ser necesario realizar modificaciones en el controlador de bus.

En el caso de los controladores de bus basados en WDF, el marco WDF registra la interfaz GUID_REENUMERATE_SELF_INTERFACE_STANDARD en nombre de los controladores. Por lo tanto, el registro de esta interfaz no es necesario para esos controladores. Si el controlador de bus debe realizar algunas operaciones antes de volver a enumerar sus dispositivos secundarios, debe registrarse para la rutina de devolución de llamada EvtChildListDeviceReenumerate y realizar las operaciones en esa rutina. Dado que se puede llamar a esta rutina de devolución de llamada en paralelo para todos los PDO, el código de la rutina podría necesitar protegerse contra las condiciones de carrera.

Restablecimiento a nivel funcional del firmware ACPI

Para admitir el restablecimiento de nivel de función de dispositivo, debe haber un método _RST definido dentro del ámbito del Dispositivo. Si está presente, este método sobrescribe la implementación del controlador del bus para el restablecimiento del dispositivo a nivel de función (si está presente) de ese dispositivo. Cuando se ejecuta, el método _RST debe restablecer solo ese dispositivo y no debe afectar a otros dispositivos. Además, el dispositivo debe permanecer conectado en el autobús.

Firmware ACPI: restablecimiento a nivel de plataforma

Para admitir el restablecimiento de dispositivos a nivel de plataforma, hay dos opciones:

  • El firmware ACPI puede definir un PowerResource que implemente el método _RST y todos los dispositivos afectados por este método de restablecimiento pueden hacer referencia a este PowerResource a través de un objeto _PRR definido en su ámbito de dispositivo.

  • El dispositivo puede declarar un objeto _PR3. En este caso, el controlador ACPI usa el ciclo de alimentación D3cold para realizar el restablecimiento y se determinarán las dependencias de restablecimiento entre dispositivos desde el objeto _PR3.

Si el objeto _PRR existe en el ámbito dispositivo, el controlador ACPI usa el método _RST en el PowerResource al que se hace referencia para realizar el restablecimiento. Si no se define ningún objeto _PRR pero se define el objeto _PR3, el controlador ACPI usa el ciclo de energía D3cold para realizar el restablecimiento. Si no se define ni el _PRR ni el objeto _PR3, el dispositivo no admite un restablecimiento de nivel de plataforma y el controlador ACPI informa de que el restablecimiento de nivel de plataforma no está disponible.

Comprobación del firmware ACPI en el sistema de prueba

Para probar el controlador que admite el restablecimiento y la recuperación del dispositivo, siga este procedimiento. En este procedimiento se supone que usa este archivo ASL de ejemplo.

DefinitionBlock("SSDT.AML", "SSDT", 0x01, "XyzOEM", "TestTabl", 0x00001000)
{
   Scope(\_SB_)
      {
       PowerResource(PWFR, 0x5, 0x0)
       {
           Method(_RST, 0x0, NotSerialized)    { }
           
           // Placeholder methods as power resources need _ON, _OFF, _STA.
           Method(_STA, 0x0, NotSerialized)
           {
               Return(0xF)
           }

           Method(_ON_, 0x0, NotSerialized)    { }

           Method(_OFF, 0x0, NotSerialized)    { }

       } // PowerResource()
   } // Scope (\_SB_)

   // Assumes WiFi device is declared under \_SB.XYZ.
   Scope(\_SB_.XYZ.WIFI)
       {

       // Declare PWFR as WiFi reset power rail
       Name(_PRR, Package(One)
           {
               \_SB_.PWFR
           })
       } // Scope (\_SB)
}
  1. Compile el archivo ASL de prueba a un AML mediante un compilador ASL, como Asl.exe. El ejecutable está incluido en el Kit de controladores de Windows (WDK).
Asl <test>.asl

El comando anterior genera SSDT.aml.

  1. Cambie el nombre de SSDT.aml a acpitabl.dat.

  2. Copie acpitabl.dat en %systemroot%\system32 en el sistema de prueba.

  3. Active la firma de prueba en el sistema de prueba.

bcdedit /set testsigning on

  1. Reinicie el sistema de prueba.

  2. Compruebe que la tabla está cargada. En el Depurador de Windows, use estos comandos.

  • !acpicache
  • dt _DESCRIPTION_HEADER dirección de la tabla SSDT
0: kd> !acpicache
Dumping cached ACPI tables...
  SSDT @(ffffffffffd03018) Rev: 0x1 Len: 0x000043 TableID: TestTabl
  XSDT @(ffffffffffd05018) Rev: 0x1 Len: 0x000114 TableID: HSW-FFRD
       ...
       ...
 
0: kd> dt _DESCRIPTION_HEADER ffffffffffd03018
ACPI!_DESCRIPTION_HEADER
   +0x000 Signature        : 0x54445353
   +0x004 Length           : 0x43
   +0x008 Revision         : 0x1 ''
   +0x009 Checksum         : 0x37 '7'
   +0x00a OEMID            : [6]  "XyzOEM"
   +0x010 OEMTableID       : [8]  "TestTabl"
   +0x018 OEMRevision      : 0x1000
   +0x01c CreatorID        : [4]  "MSFT"
   +0x020 CreatorRev       : 0x5000000

Consulte también

_DEVICE_RESET_INTERFACE_STANDARD

  • Last updated on