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

See also

DeviceReset

INTERFACE

IRP_MN_QUERY_INTERFACE

InterfaceDereference

InterfaceReference