Bewerken

Delen via


DEVICE_RESET_INTERFACE_STANDARD structure (wdm.h)

The DEVICE_RESET_INTERFACE_STANDARD structure enables function drivers to reset and recover malfunctioning devices. This structure describes the GUID_DEVICE_RESET_INTERFACE_STANDARD interface.

For more information see Working with the 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;

Members

Size

The size, in bytes, of this structure.

Version

The driver-defined interface version.

Context

A pointer to interface-specific context information.

InterfaceReference

A pointer to an InterfaceReference routine that increments the interface's reference count.

InterfaceDereference

A pointer to an InterfaceDereference routine that decrements the interface's reference count.

DeviceReset

A pointer to the interface's DeviceReset routine. This routine can be used by function drivers to attempt to reset and recover a malfunctioning device.

SupportedResetTypes

Defines the ULONG parameter SupportedResetTypes.

Reserved

Reserved for future use.

QueryBusSpecificResetInfo

Defines the PDEVICE_QUERY_BUS_SPECIFIC_RESET_HANDLER parameter QueryBusSpecificResetInfo.

DeviceBusSpecificReset

Defines the PDEVICE_BUS_SPECIFIC_RESET_HANDLER parameter DeviceBusSpecificReset.

GetDeviceResetStatus

Defines the PGET_DEVICE_RESET_STATUS parameter GetDeviceResetStatus.

Remarks

The DEVICE_RESET_INTERFACE_STANDARD structure is an extension of the INTERFACE structure. A driver obtains a pointer to the DEVICE_RESET_INTERFACE_STANDARD structure by sending an IRP_MN_QUERY_INTERFACE IRP to its bus driver with InterfaceType set to GUID_DEVICE_RESET_INTERFACE_STANDARD.

For more information about the purpose of this interface, see Working with the GUID_DEVICE_RESET_INTERFACE_STANDARD.

Requirements

Requirement Value
Minimum supported client Windows 10
Header wdm.h (include Wdm.h)

See also

DeviceReset

INTERFACE

IRP_MN_QUERY_INTERFACE

InterfaceDereference

InterfaceReference