structure DEVICE_RESET_INTERFACE_STANDARD (wdm.h)

Article
02/27/2024

La structure DEVICE_RESET_INTERFACE_STANDARD permet aux pilotes de fonction de réinitialiser et de récupérer les appareils défectueux. Cette structure décrit l’interface GUID_DEVICE_RESET_INTERFACE_STANDARD.

Pour plus d’informations, consultez Utilisation du GUID_DEVICE_RESET_INTERFACE_STANDARD.

Syntaxe

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;

Membres

Size

Taille, en octets, de cette structure.

Version

Version de l’interface définie par le pilote.

Context

Pointeur vers des informations de contexte spécifiques à l’interface.

InterfaceReference

Pointeur vers une routine InterfaceReference qui incrémente le nombre de références de l’interface.

InterfaceDereference

Pointeur vers une routine InterfaceDereference qui décrémente le nombre de références de l’interface.

DeviceReset

Pointeur vers la routine DeviceReset de l’interface. Cette routine peut être utilisée par les pilotes de fonction pour tenter de réinitialiser et de récupérer un appareil défectueux.

SupportedResetTypes

Définit le paramètre ULONGSupportedResetTypes.

Reserved

Réservé pour un usage futur.

QueryBusSpecificResetInfo

Définit le paramètre PDEVICE_QUERY_BUS_SPECIFIC_RESET_HANDLERQueryBusSpecificResetInfo.

DeviceBusSpecificReset

Définit le paramètre PDEVICE_BUS_SPECIFIC_RESET_HANDLERDeviceBusSpecificReset.

GetDeviceResetStatus

Définit le paramètre PGET_DEVICE_RESET_STATUSGetDeviceResetStatus.

Remarques

La structure DEVICE_RESET_INTERFACE_STANDARD est une extension de la structure INTERFACE . Un pilote obtient un pointeur vers la structure DEVICE_RESET_INTERFACE_STANDARD en envoyant un IRP IRP_MN_QUERY_INTERFACE à son pilote de bus avec InterfaceType défini sur GUID_DEVICE_RESET_INTERFACE_STANDARD.

Pour plus d’informations sur l’objectif de cette interface, consultez Utilisation de l’GUID_DEVICE_RESET_INTERFACE_STANDARD.