DEVICE_RESET_INTERFACE_STANDARD 結構 (wdm.h)

發行項
02/27/2024

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 結構的延伸。驅動程式會藉由將 IRP_MN_QUERY_INTERFACE IRP 傳送至其總線驅動程式，並將 InterfaceType 設定為 GUID_DEVICE_RESET_INTERFACE_STANDARD，以取得DEVICE_RESET_INTERFACE_STANDARD結構的指標。

如需此介面用途的詳細資訊，請參閱使用GUID_DEVICE_RESET_INTERFACE_STANDARD。