estructura de DEVICE_RESET_INTERFACE_STANDARD (wdm.h)

Artículo
03/05/2024

La estructura de DEVICE_RESET_INTERFACE_STANDARD permite a los controladores de función restablecer y recuperar dispositivos que no funcionan correctamente. Esta estructura describe la interfaz GUID_DEVICE_RESET_INTERFACE_STANDARD.

Para obtener más información, vea Trabajar con el GUID_DEVICE_RESET_INTERFACE_STANDARD.

Sintaxis

typedef struct _DEVICE_RESET_INTERFACE_STANDARD {
  USHORT                                   Size;
  USHORT                                   Version;
  PVOID                                    Context;
  PINTERFACE_REFERENCE                     InterfaceReference;
  PINTERFACE_DEREFERENCE                   InterfaceDereference;
  PDEVICE_RESET_HANDLER                    DeviceReset;
  ULONG                                    SupportedResetTypes;
  PVOID                                    Reserved;
  PDEVICE_QUERY_BUS_SPECIFIC_RESET_HANDLER QueryBusSpecificResetInfo;
  PDEVICE_BUS_SPECIFIC_RESET_HANDLER       DeviceBusSpecificReset;
  PGET_DEVICE_RESET_STATUS                 GetDeviceResetStatus;
} DEVICE_RESET_INTERFACE_STANDARD, *PDEVICE_RESET_INTERFACE_STANDARD;

Miembros

Size

Tamaño, en bytes, de esta estructura.

Version

Versión de la interfaz definida por el controlador.

Context

Puntero a información de contexto específica de la interfaz.

InterfaceReference

Puntero a una rutina InterfaceReference que incrementa el recuento de referencias de la interfaz.

InterfaceDereference

Puntero a una rutina InterfaceDereference que disminuye el recuento de referencias de la interfaz.

DeviceReset

Puntero a la rutina DeviceReset de la interfaz. Los controladores de función pueden usar esta rutina para intentar restablecer y recuperar un dispositivo que no funciona correctamente.

SupportedResetTypes

Define el parámetro ULONGSupportedResetTypes.

Reserved

Reservado para uso futuro.

QueryBusSpecificResetInfo

Define el parámetro PDEVICE_QUERY_BUS_SPECIFIC_RESET_HANDLERQueryBusSpecificResetInfo.

DeviceBusSpecificReset

Define el parámetro PDEVICE_BUS_SPECIFIC_RESET_HANDLERDeviceBusSpecificReset.

GetDeviceResetStatus

Define el parámetro PGET_DEVICE_RESET_STATUSGetDeviceResetStatus.

Comentarios

La estructura DEVICE_RESET_INTERFACE_STANDARD es una extensión de la estructura INTERFACE . Un controlador obtiene un puntero a la estructura de DEVICE_RESET_INTERFACE_STANDARD enviando un IRP de IRP_MN_QUERY_INTERFACE a su controlador de autobús con InterfaceType establecido en GUID_DEVICE_RESET_INTERFACE_STANDARD.

Para obtener más información sobre el propósito de esta interfaz, vea Trabajar con el GUID_DEVICE_RESET_INTERFACE_STANDARD.