DEVICE_RESET_INTERFACE_STANDARD 구조체(wdm.h)

아티클
03/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 작업을 참조하세요.