DEVICE_RESET_INTERFACE_STANDARD 構造体 (wdm.h)

[アーティクル]
03/05/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 構造体の拡張です。ドライバーは、interfaceType が GUID_DEVICE_RESET_INTERFACE_STANDARD に設定されたIRP_MN_QUERY_INTERFACE IRP をバスドライバーに送信することで、DEVICE_RESET_INTERFACE_STANDARD構造体へのポインターを取得します。

このインターフェイスの目的の詳細については、「 GUID_DEVICE_RESET_INTERFACE_STANDARDの操作」を参照してください。