DEVICE_RESET_INTERFACE_STANDARD-Struktur (wdm.h)

Artikel
02/27/2024

Die DEVICE_RESET_INTERFACE_STANDARD-Struktur ermöglicht Funktionstreibern das Zurücksetzen und Wiederherstellen fehlerhafter Geräte. Diese Struktur beschreibt die GUID_DEVICE_RESET_INTERFACE_STANDARD-Schnittstelle.

Weitere Informationen finden Sie unter Arbeiten mit dem GUID_DEVICE_RESET_INTERFACE_STANDARD.

Syntax

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;

Member

Size

Die Größe (in Bytes) dieser Struktur.

Version

Die vom Treiber definierte Schnittstellenversion.

Context

Ein Zeiger auf schnittstellenspezifische Kontextinformationen.

InterfaceReference

Ein Zeiger auf eine InterfaceReference-Routine , die die Referenzanzahl der Schnittstelle erhöht.

InterfaceDereference

Ein Zeiger auf eine InterfaceDereference-Routine , die die Referenzanzahl der Schnittstelle erhöht.

DeviceReset

Ein Zeiger auf die DeviceReset-Routine der Schnittstelle. Diese Routine kann von Funktionstreibern verwendet werden, um zu versuchen, ein fehlerhaftes Gerät zurückzusetzen und wiederherzustellen.

SupportedResetTypes

Definiert den ULONG-ParameterSupportedResetTypes.

Reserved

Für die zukünftige Verwendung reserviert.

QueryBusSpecificResetInfo

Definiert den PDEVICE_QUERY_BUS_SPECIFIC_RESET_HANDLER Parameter QueryBusSpecificResetInfo.

DeviceBusSpecificReset

Definiert den PDEVICE_BUS_SPECIFIC_RESET_HANDLER-ParameterDeviceBusSpecificReset.

GetDeviceResetStatus

Definiert den PGET_DEVICE_RESET_STATUS-ParameterGetDeviceResetStatus.

Hinweise

Die DEVICE_RESET_INTERFACE_STANDARD-Struktur ist eine Erweiterung der INTERFACE-Struktur . Ein Treiber ruft einen Zeiger auf die DEVICE_RESET_INTERFACE_STANDARD-Struktur ab, indem er eine IRP_MN_QUERY_INTERFACE IRP an seinen Bustreiber sendet, wobei InterfaceType auf GUID_DEVICE_RESET_INTERFACE_STANDARD festgelegt ist.

Weitere Informationen zum Zweck dieser Schnittstelle finden Sie unter Arbeiten mit dem GUID_DEVICE_RESET_INTERFACE_STANDARD.