estrutura DEVICE_RESET_INTERFACE_STANDARD (wdm.h)

Artigo
08/08/2023

A estrutura DEVICE_RESET_INTERFACE_STANDARD permite que os drivers de função redefinam e recuperem dispositivos com mau funcionamento. Essa estrutura descreve a interface GUID_DEVICE_RESET_INTERFACE_STANDARD.

Para obter mais informações, consulte Trabalhando com o GUID_DEVICE_RESET_INTERFACE_STANDARD.

Sintaxe

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;

Membros

Size

O tamanho, em bytes, dessa estrutura.

Version

A versão da interface definida pelo driver.

Context

Um ponteiro para informações de contexto específicas da interface.

InterfaceReference

Um ponteiro para uma rotina InterfaceReference que incrementa a contagem de referência da interface.

InterfaceDereference

Um ponteiro para uma rotina InterfaceDereference que diminui a contagem de referência da interface.

DeviceReset

Um ponteiro para a rotina DeviceReset da interface. Essa rotina pode ser usada por drivers de função para tentar redefinir e recuperar um dispositivo com mau funcionamento.

SupportedResetTypes

Define o parâmetro ULONGSupportedResetTypes.

Reserved

Reservado para uso futuro.

QueryBusSpecificResetInfo

Define o parâmetro PDEVICE_QUERY_BUS_SPECIFIC_RESET_HANDLERQueryBusSpecificResetInfo.

DeviceBusSpecificReset

Define o parâmetro PDEVICE_BUS_SPECIFIC_RESET_HANDLERDeviceBusSpecificReset.

GetDeviceResetStatus

Define o parâmetro PGET_DEVICE_RESET_STATUSGetDeviceResetStatus.

Comentários

A estrutura DEVICE_RESET_INTERFACE_STANDARD é uma extensão da estrutura interface . Um driver obtém um ponteiro para a estrutura DEVICE_RESET_INTERFACE_STANDARD enviando um IRP IRP_MN_QUERY_INTERFACE para seu driver de barramento com InterfaceType definido como GUID_DEVICE_RESET_INTERFACE_STANDARD.

Para obter mais informações sobre a finalidade dessa interface, consulte Trabalhando com o GUID_DEVICE_RESET_INTERFACE_STANDARD.