struttura DEVICE_RESET_INTERFACE_STANDARD (wdm.h)

Articolo
02/27/2024

La struttura DEVICE_RESET_INTERFACE_STANDARD consente ai driver di funzione di reimpostare e ripristinare i dispositivi che non funzionano correttamente. Questa struttura descrive l'interfaccia GUID_DEVICE_RESET_INTERFACE_STANDARD.

Per altre informazioni, vedere Uso del GUID_DEVICE_RESET_INTERFACE_STANDARD.

Sintassi

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;

Members

Size

Dimensione, in byte, della struttura.

Version

Versione dell'interfaccia definita dal driver.

Context

Puntatore a informazioni di contesto specifiche dell'interfaccia.

InterfaceReference

Puntatore a una routine InterfaceReference che incrementa il conteggio dei riferimenti dell'interfaccia.

InterfaceDereference

Puntatore a una routine InterfaceDereference che decrementa il conteggio dei riferimenti dell'interfaccia.

DeviceReset

Puntatore alla routine DeviceReset dell'interfaccia. Questa routine può essere usata dai driver di funzione per tentare di reimpostare e ripristinare un dispositivo non funzionante.

SupportedResetTypes

Definisce il parametro ULONGSupportedResetTypes.

Reserved

Riservato per utilizzi futuri.

QueryBusSpecificResetInfo

Definisce il parametro PDEVICE_QUERY_BUS_SPECIFIC_RESET_HANDLERQueryBusSpecificResetInfo.

DeviceBusSpecificReset

Definisce il parametro PDEVICE_BUS_SPECIFIC_RESET_HANDLERDeviceBusSpecificReset.

GetDeviceResetStatus

Definisce il parametro PGET_DEVICE_RESET_STATUSGetDeviceResetStatus.

Commenti

La struttura DEVICE_RESET_INTERFACE_STANDARD è un'estensione della struttura INTERFACE . Un driver ottiene un puntatore alla struttura DEVICE_RESET_INTERFACE_STANDARD inviando un IRP_MN_QUERY_INTERFACE IRP al driver del bus con InterfaceType impostato su GUID_DEVICE_RESET_INTERFACE_STANDARD.

Per altre informazioni sullo scopo di questa interfaccia, vedere Uso del GUID_DEVICE_RESET_INTERFACE_STANDARD.