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

None

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 volver a iniciar el PPM con 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 iniciar la anulación de sus máquinas de estado interno. Se recomienda que el cliente llame a UcmUcsiPpmStop desde su devolución de llamada EVT_WDF_DEVICE_RELEASE_HARDWARE.

Dado que UcmUcsiPpmStop se basa en el envío de comandos UCSI a PPM a través de 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 UcmUcsiPpmStop , se puede llamar a UcmUcsiPpmStart para iniciar el PPM de nuevo.

Requisitos

Requisito	Value
Versión mínima de KMDF	1.27
Versión mínima de UMDF	N/D
Encabezado	ucmucsippm.h (incluya UcmUcsiCx.h)
Library	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL