wdm.h) (DEVICE_RESET_INTERFACE_STANDARD 结构

项目
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

定义 ULONG 参数 SupportedResetTypes。

Reserved

保留供将来使用。

QueryBusSpecificResetInfo

定义 PDEVICE_QUERY_BUS_SPECIFIC_RESET_HANDLER 参数 QueryBusSpecificResetInfo。

DeviceBusSpecificReset

定义 PDEVICE_BUS_SPECIFIC_RESET_HANDLER 参数 DeviceBusSpecificReset。

GetDeviceResetStatus

定义 PGET_DEVICE_RESET_STATUS 参数 GetDeviceResetStatus。

注解

DEVICE_RESET_INTERFACE_STANDARD 结构是 INTERFACE 结构的扩展。驱动程序通过将 interfaceType 设置为 GUID_DEVICE_RESET_INTERFACE_STANDARD 将 IRP_MN_QUERY_INTERFACE IRP 发送到其总线驱动程序来获取指向 DEVICE_RESET_INTERFACE_STANDARD 结构的指针。

有关此接口用途的详细信息，请参阅使用GUID_DEVICE_RESET_INTERFACE_STANDARD。