Función UcmUcsiPpmStop (ucmucsippm.h)

Indica a la extensión de clase UcmUcsiCx que deje de enviar solicitudes al controlador cliente.

Sintaxis

void UcmUcsiPpmStop(
  [in] UCMUCSIPPM PpmObject
);

Parámetros

[in] PpmObject

Identificador de un objeto Platform Policy Manager (PPM) que el controlador cliente recibió en la llamada anterior a UcmUcsiPpmCreate.

Valor devuelto

Ninguno

Observaciones

UcmUcsiPpmStop indica que el controlador cliente ya no está listo para recibir solicitudes de la extensión de clase. La extensión de clase garantiza que no se realizarán solicitudes al cliente después de que se devuelva esta llamada. El controlador debe llamar a esta DDI cuando encuentra un error y quiere que la extensión de clase deje de enviar solicitudes PPM. Una vez completada la llamada, el controlador debe iniciar el PPM de nuevo mediante UcmUcsiPpmStart.

Se espera que el controlador cliente llame a este DDI en la descarga del controlador. Esta llamada indica la extensión de clase para empezar a anular sus máquinas de estado interno. Se recomienda que el cliente llame a UcmUcsiPpmStop desde su devolución de llamada de EVT_WDF_DEVICE_RELEASE_HARDWARE.

Dado que UcmUcsiPpmStop se basa en el envío de comandos UCSI a PPM sobre la WDFQUEUE administrada por energía proporcionada por el controlador cliente, un intento de llamar a esta función desde EVT_WDF_DEVICE_D0_EXIT devolución de llamada produce un error. Esto se debe a que en este momento se cierran las puertas de envío de la cola.

Después de que se devuelva el UcmUcsiPpmStop, se puede llamar a UcmUcsiPpmStart para iniciar el PPM de nuevo.

Requisitos

Requisito	Valor
versión mínima de KMDF	1.27
versión mínima de UMDF	N/A
encabezado de	ucmucsippm.h (incluya UcmUcsiCx.h)
biblioteca de	UcmUcsiCxStub.lib
irQL	PASSIVE_LEVEL