estrutura WDF_PNPPOWER_EVENT_CALLBACKS (wdfdevice.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

A estrutura WDF_PNPPOWER_EVENT_CALLBACKS contém ponteiros para as funções de retorno de chamada de evento de energia e Plug and Play de um driver.

Sintaxe

typedef struct _WDF_PNPPOWER_EVENT_CALLBACKS {
  ULONG                                           Size;
  PFN_WDF_DEVICE_D0_ENTRY                         EvtDeviceD0Entry;
  PFN_WDF_DEVICE_D0_ENTRY_POST_INTERRUPTS_ENABLED EvtDeviceD0EntryPostInterruptsEnabled;
  PFN_WDF_DEVICE_D0_EXIT                          EvtDeviceD0Exit;
  PFN_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED  EvtDeviceD0ExitPreInterruptsDisabled;
  PFN_WDF_DEVICE_PREPARE_HARDWARE                 EvtDevicePrepareHardware;
  PFN_WDF_DEVICE_RELEASE_HARDWARE                 EvtDeviceReleaseHardware;
  PFN_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP          EvtDeviceSelfManagedIoCleanup;
  PFN_WDF_DEVICE_SELF_MANAGED_IO_FLUSH            EvtDeviceSelfManagedIoFlush;
  PFN_WDF_DEVICE_SELF_MANAGED_IO_INIT             EvtDeviceSelfManagedIoInit;
  PFN_WDF_DEVICE_SELF_MANAGED_IO_SUSPEND          EvtDeviceSelfManagedIoSuspend;
  PFN_WDF_DEVICE_SELF_MANAGED_IO_RESTART          EvtDeviceSelfManagedIoRestart;
  PFN_WDF_DEVICE_SURPRISE_REMOVAL                 EvtDeviceSurpriseRemoval;
  PFN_WDF_DEVICE_QUERY_REMOVE                     EvtDeviceQueryRemove;
  PFN_WDF_DEVICE_QUERY_STOP                       EvtDeviceQueryStop;
  PFN_WDF_DEVICE_USAGE_NOTIFICATION               EvtDeviceUsageNotification;
  PFN_WDF_DEVICE_RELATIONS_QUERY                  EvtDeviceRelationsQuery;
  PFN_WDF_DEVICE_USAGE_NOTIFICATION_EX            EvtDeviceUsageNotificationEx;
} WDF_PNPPOWER_EVENT_CALLBACKS, *PWDF_PNPPOWER_EVENT_CALLBACKS;

Membros

Size

O tamanho, em bytes, dessa estrutura.

EvtDeviceD0Entry

Um ponteiro para a função de retorno de chamada de evento EvtDeviceD0Entry do driver ou NULL.

EvtDeviceD0EntryPostInterruptsEnabled

Um ponteiro para a função de retorno de chamada de evento EvtDeviceD0EntryPostInterruptsEnabled do driver ou NULL.

EvtDeviceD0Exit

Um ponteiro para a função de retorno de chamada de evento EvtDeviceD0Exit do driver ou NULL.

EvtDeviceD0ExitPreInterruptsDisabled

Um ponteiro para a função de retorno de chamada de evento EvtDeviceD0ExitPreInterruptsDisabled do driver ou NULL.

EvtDevicePrepareHardware

Um ponteiro para a função de retorno de chamada de evento EvtDevicePrepareHardware do driver ou NULL.

EvtDeviceReleaseHardware

Um ponteiro para a função de retorno de chamada de evento EvtDeviceReleaseHardware do driver ou NULL.

EvtDeviceSelfManagedIoCleanup

Um ponteiro para a função de retorno de chamada de evento EvtDeviceSelfManagedIoCleanup do driver ou NULL.

EvtDeviceSelfManagedIoFlush

Um ponteiro para a função de retorno de chamada de evento EvtDeviceSelfManagedIoFlush do driver ou NULL.

EvtDeviceSelfManagedIoInit

Um ponteiro para a função de retorno de chamada de evento EvtDeviceSelfManagedIoInit do driver ou NULL.

EvtDeviceSelfManagedIoSuspend

Um ponteiro para a função de retorno de chamada de evento EvtDeviceSelfManagedIoSuspend do driver ou NULL.

EvtDeviceSelfManagedIoRestart

Um ponteiro para a função de retorno de chamada de evento EvtDeviceSelfManagedIoRestart do driver ou NULL.

EvtDeviceSurpriseRemoval

Um ponteiro para a função de retorno de chamada de evento EvtDeviceSurpriseRemoval do driver ou NULL.

EvtDeviceQueryRemove

Um ponteiro para a função de retorno de chamada de evento EvtDeviceQueryRemove do driver ou NULL.

EvtDeviceQueryStop

Um ponteiro para a função de retorno de chamada de evento EvtDeviceQueryStop do driver ou NULL.

EvtDeviceUsageNotification

Um ponteiro para a função de retorno de chamada de evento EvtDeviceUsageNotification do driver ou NULL.

EvtDeviceRelationsQuery

Um ponteiro para a função de retorno de chamada de evento EvtDeviceRelationsQuery do driver ou NULL.

EvtDeviceUsageNotificationEx

Um ponteiro para a função de retorno de chamada de evento EvtDeviceUsageNotificationEx do driver ou NULL. O membro EvtDeviceUsageNotificationEx está disponível na versão 1.11 e versões posteriores do KMDF. Um driver pode registrar EvtDeviceRelationsQuery ou EvtDeviceUsageNotificationEx, mas não ambos.

Comentários

A estrutura WDF_PNPPOWER_EVENT_CALLBACKS é usada como entrada para o método WdfDeviceInitSetPnpPowerEventCallbacks .

O driver deve inicializar sua estrutura de WDF_PNPPOWER_EVENT_CALLBACKS chamando WDF_PNPPOWER_EVENT_CALLBACKS_INIT.

Requisitos

Requisito Valor
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (inclua Wdf.h)

Confira também

WDF_POWER_POLICY_EVENT_CALLBACKS