estructura WDF_PNPPOWER_EVENT_CALLBACKS (wdfdevice.h)
[Se aplica a KMDF y UMDF]
La estructura WDF_PNPPOWER_EVENT_CALLBACKS contiene punteros a las funciones de devolución de llamada de Plug and Play y de eventos de energía de un controlador.
Sintaxis
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;
Miembros
Size
Tamaño, en bytes, de esta estructura.
EvtDeviceD0Entry
Puntero a la función de devolución de llamada de eventos EvtDeviceD0Entry del controlador o NULL.
EvtDeviceD0EntryPostInterruptsEnabled
Puntero a la función de devolución de llamada de eventos EvtDeviceD0EntryPostInterruptsEnabled del controlador o NULL.
EvtDeviceD0Exit
Puntero a la función de devolución de llamada de eventos EvtDeviceD0Exit del controlador o NULL.
EvtDeviceD0ExitPreInterruptsDisabled
Puntero a la función de devolución de llamada de eventos EvtDeviceD0ExitPreInterruptsDisabled del controlador o NULL.
EvtDevicePrepareHardware
Puntero a la función de devolución de llamada de eventos EvtDevicePrepareHardware del controlador o NULL.
EvtDeviceReleaseHardware
Puntero a la función de devolución de llamada de eventos EvtDeviceReleaseHardware del controlador o NULL.
EvtDeviceSelfManagedIoCleanup
Puntero a la función de devolución de llamada de evento EvtDeviceSelfManagedIoCleanup del controlador o NULL.
EvtDeviceSelfManagedIoFlush
Puntero a la función de devolución de llamada de evento EvtDeviceSelfManagedIoFlush del controlador o NULL.
EvtDeviceSelfManagedIoInit
Puntero a la función de devolución de llamada de eventos EvtDeviceSelfManagedIoInit del controlador o NULL.
EvtDeviceSelfManagedIoSuspend
Puntero a la función de devolución de llamada de eventos EvtDeviceSelfManagedIoSuspend del controlador o NULL.
EvtDeviceSelfManagedIoRestart
Puntero a la función de devolución de llamada de eventos EvtDeviceSelfManagedIoRestart del controlador o NULL.
EvtDeviceSurpriseRemoval
Puntero a la función de devolución de llamada de eventos EvtDeviceSurpriseRemoval del controlador o NULL.
EvtDeviceQueryRemove
Puntero a la función de devolución de llamada de eventos EvtDeviceQueryRemove del controlador o NULL.
EvtDeviceQueryStop
Puntero a la función de devolución de llamada de eventos EvtDeviceQueryStop del controlador o NULL.
EvtDeviceUsageNotification
Puntero a la función de devolución de llamada de eventos EvtDeviceUsageNotification del controlador o NULL.
EvtDeviceRelationsQuery
Puntero a la función de devolución de llamada de eventos EvtDeviceRelationsQuery del controlador o NULL.
EvtDeviceUsageNotificationEx
Puntero a la función de devolución de llamada de eventos EvtDeviceUsageNotificationEx del controlador o NULL. El miembro EvtDeviceUsageNotificationEx está disponible en la versión 1.11 y versiones posteriores de KMDF. Un controlador puede registrar EvtDeviceRelationsQuery o EvtDeviceUsageNotificationEx, pero no ambos.
Comentarios
La estructura WDF_PNPPOWER_EVENT_CALLBACKS se usa como entrada para el método WdfDeviceInitSetPnpPowerEventCallbacks .
El controlador debe inicializar su estructura de WDF_PNPPOWER_EVENT_CALLBACKS llamando a WDF_PNPPOWER_EVENT_CALLBACKS_INIT.
Requisitos
| Requisito | Value |
|---|---|
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfdevice.h (incluya Wdf.h) |