структура DEVICE_RESET_INTERFACE_STANDARD (wdm.h)

Статья
08/08/2023

Структура DEVICE_RESET_INTERFACE_STANDARD позволяет драйверам функций сбрасывать и восстанавливать неисправные устройства. Эта структура описывает интерфейс GUID_DEVICE_RESET_INTERFACE_STANDARD.

Дополнительные сведения см. в статье Работа с GUID_DEVICE_RESET_INTERFACE_STANDARD.

Синтаксис

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;

Члены

Size

Размер данной структуры (в байтах).

Version

Версия интерфейса, определяемого драйвером.

Context

Указатель на сведения о контексте для конкретного интерфейса.

InterfaceReference

Указатель на подпрограмму InterfaceReference , которая увеличивает число ссылок интерфейса.

InterfaceDereference

Указатель на подпрограмму InterfaceDereference , которая уменьшает количество ссылок интерфейса.

DeviceReset

Указатель на подпрограмму DeviceReset интерфейса. Эта подпрограмма может использоваться драйверами функций для попытки сбросить и восстановить неисправное устройство.

SupportedResetTypes

Определяет параметр ULONGSupportedResetTypes.

Reserved

Зарезервировано для последующего использования.

QueryBusSpecificResetInfo

Определяет параметр PDEVICE_QUERY_BUS_SPECIFIC_RESET_HANDLERQueryBusSpecificResetInfo.

DeviceBusSpecificReset

Определяет параметр PDEVICE_BUS_SPECIFIC_RESET_HANDLERDeviceBusSpecificReset.

GetDeviceResetStatus

Определяет параметр PGET_DEVICE_RESET_STATUSGetDeviceResetStatus.

Структура DEVICE_RESET_INTERFACE_STANDARD является расширением структуры INTERFACE . Драйвер получает указатель на структуру DEVICE_RESET_INTERFACE_STANDARD , отправляя IRP_MN_QUERY_INTERFACE IRP драйверу шины с параметром InterfaceType , для GUID_DEVICE_RESET_INTERFACE_STANDARD.

Дополнительные сведения о назначении этого интерфейса см. в разделе Работа с GUID_DEVICE_RESET_INTERFACE_STANDARD.