Compartir a través de

Función UcmUcsiPpmStart (Ucmucsippm.h)

  • Artículo

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

Sintaxis

NTSTATUS UcmUcsiPpmStart(
  [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

Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método puede devolver un valor NTSTATUS adecuado.

Comentarios

UcmUcsiPpmStart indica que el controlador cliente ya está listo para recibir la solicitud de la extensión de clase. Tras esta llamada, la extensión de clase inicia el Administrador de directivas del sistema operativo (OPM) y los equipos de estado del controlador de comandos.

El controlador cliente debe llamar a UcmUcsiPpmStart después de haber llamado A UcmUcsiPpmStop para la recuperación de errores.

Esta DDI inicia las operaciones que la extensión de clase necesita realizar para inicializar las máquinas de estado del controlador de comandos y OPM. El controlador cliente debe llamar a UcmUcsiPpmStart para notificar a UcmUcsiCx que el controlador está listo para recibir las solicitudes IOCTL. Se recomienda realizar esta llamada desde la función de devolución de llamada EVT_WDF_DEVICE_PREPARE_HARDWARE o después de que el sistema llame a esta devolución de llamada.

Si intenta iniciar el PPM después de que ya se haya iniciado, se producirá una condición de error.

Después de que el cliente llame a UcmUcsiPpmStart, la extensión de clase envía varios comandos al firmware PPM para obtener funcionalidades de PPM y conectores y sus estados. Debido a una gran cantidad de interacciones con el firmware, se recomienda encarecidamente que los implementadores de cliente UcmUcsiCx llamen a este DDI una vez durante el inicio y no se reanuden desde un estado de baja energía, como la devolución de llamada D0Entry. Esto es especialmente cierto cuando el cliente implementa el idling S0.

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