struktur DEVICE_RESET_INTERFACE_STANDARD (wdm.h)

Artikel
02/27/2024

Struktur DEVICE_RESET_INTERFACE_STANDARD memungkinkan driver fungsi untuk mengatur ulang dan memulihkan perangkat yang tidak berfungsi. Struktur ini menjelaskan antarmuka GUID_DEVICE_RESET_INTERFACE_STANDARD.

Untuk informasi selengkapnya lihat Bekerja dengan GUID_DEVICE_RESET_INTERFACE_STANDARD.

Sintaks

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;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

Version

Versi antarmuka yang ditentukan driver.

Context

Penunjuk ke informasi konteks khusus antarmuka.

InterfaceReference

Penunjuk ke rutinitas InterfaceReference yang menaikkan jumlah referensi antarmuka.

InterfaceDereference

Penunjuk ke rutinitas InterfaceDereference yang mengurangi jumlah referensi antarmuka.

DeviceReset

Penunjuk ke rutinitas DeviceReset antarmuka. Rutinitas ini dapat digunakan oleh driver fungsi untuk mencoba mengatur ulang dan memulihkan perangkat yang tidak berfungsi.

SupportedResetTypes

Menentukan parameter ULONGSupportedResetTypes.

Reserved

Disiapkan untuk penggunaan masa mendatang.

QueryBusSpecificResetInfo

Menentukan parameter PDEVICE_QUERY_BUS_SPECIFIC_RESET_HANDLERQueryBusSpecificResetInfo.

DeviceBusSpecificReset

Menentukan parameter PDEVICE_BUS_SPECIFIC_RESET_HANDLERDeviceBusSpecificReset.

GetDeviceResetStatus

Menentukan parameter PGET_DEVICE_RESET_STATUSGetDeviceResetStatus.

Keterangan

Struktur DEVICE_RESET_INTERFACE_STANDARD adalah perpanjangan dari struktur INTERFACE . Driver mendapatkan pointer ke struktur DEVICE_RESET_INTERFACE_STANDARD dengan mengirim IRP IRP_MN_QUERY_INTERFACE ke driver busnya dengan InterfaceType diatur ke GUID_DEVICE_RESET_INTERFACE_STANDARD.

Untuk informasi selengkapnya tentang tujuan antarmuka ini, lihat Bekerja dengan GUID_DEVICE_RESET_INTERFACE_STANDARD.