Función WdfDeviceInitRegisterPnpStateChangeCallback (wdfdevice.h)

  • Artículo

[Solo se aplica a KMDF]

Nota

Este método es solo para uso interno de Microsoft.

El método WdfDeviceInitRegisterPnpStateChangeCallback registra una función de devolución de llamada de eventos proporcionada por el controlador que el marco llama cuando la máquina de estado de un dispositivo Plug and Play cambia el estado.

Sintaxis

NTSTATUS WdfDeviceInitRegisterPnpStateChangeCallback(
  [in] PWDFDEVICE_INIT                              DeviceInit,
  [in] WDF_DEVICE_PNP_STATE                         PnpState,
  [in] PFN_WDF_DEVICE_PNP_STATE_CHANGE_NOTIFICATION EvtDevicePnpStateChange,
  [in] ULONG                                        CallbackTypes
);

Parámetros

[in] DeviceInit

Puntero proporcionado por el autor de la llamada a una estructura WDFDEVICE_INIT .

[in] PnpState

Enumerador WDF_DEVICE_PNP_STATE que identifica el estado de la máquina Plug and Play para el que el controlador solicita una notificación.

[in] EvtDevicePnpStateChange

Puntero proporcionado por el autor de la llamada a la función de devolución de llamada EvtDevicePnpStateChange del controlador.

[in] CallbackTypes

Combinación de ORed de enumeradores con tipo WDF_STATE_NOTIFICATION_TYPE.

Valor devuelto

Si la operación se realiza correctamente, WdfDeviceInitRegisterPnpStateChangeCallback devuelve STATUS_SUCCESS. Entre los valores devueltos adicionales se incluyen:

Código devuelto Descripción
STATUS_INVALID_PARAMETER
 Se ha detectado un parámetro no válido.
STATUS_INSUFFICIENT_RESOURCES
 No hay memoria suficiente para completar la operación.

Comentarios

Si el controlador llama a WdfDeviceInitRegisterPnpStateChangeCallback, debe hacerlo antes de llamar a WdfDeviceCreate.

Para obtener más información sobre WdfDeviceInitRegisterPnpStateChangeCallback, vea State Machines in the Framework.

Ejemplos

En el ejemplo de código siguiente se registra una función de devolución de llamada de evento a la que llamará el marco cuando el equipo de estado del dispositivo Plug and Play cambie el estado.

status = WdfDeviceInitRegisterPnpStateChangeCallback(
                                                     DeviceInit,
                                                     WdfDevStatePnpEjectFailed,
                                                     MyDrvPnPStateChangeCallback,
                                                     StateNotificationAllStates
                                                     );

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfdevice.h (incluya Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf)

Consulte también

EvtDevicePnpStateChange

WDFDEVICE_INIT

WDF_DEVICE_PNP_STATE

WDF_STATE_NOTIFICATION_TYPE