Share via

Función UcmUcsiPpmCreate (Ucmucsippm.h)

  • Artículo

Crea un objeto Platform Policy Manager (PPM).

Sintaxis

NTSTATUS UcmUcsiPpmCreate(
  [in]  WDFDEVICE              WdfDevice,
  [in]  PUCMUCSI_PPM_CONFIG    Config,
  [in]  PWDF_OBJECT_ATTRIBUTES Attributes,
  [out] UCMUCSIPPM             *PPMObject
);

Parámetros

[in] WdfDevice

Identificador de un objeto de dispositivo de marco que el controlador cliente recibió en la llamada anterior a WdfDeviceCreate.

[in] Config

Puntero a una estructura de UCMUCSI_PPM_CONFIG proporcionada por el autor de la llamada que se inicializa mediante una llamada a UCMUCSI_PPM_CONFIG_INIT. El miembro ConnectorCollectionHandle debe establecerse en el identificador recuperado en una llamada anterior a UcmUcsiConnectorCollectionCreate.

[in] Attributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES proporcionada por el autor de la llamada que contiene atributos para el nuevo objeto de colección de conectores. Este parámetro es opcional y puede ser WDF_NO_OBJECT_ATTRIBUTES.

[out] PPMObject

Puntero a una ubicación que recibe un identificador para el nuevo objeto PPM.

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

Se espera que el controlador de cliente llame a UcmUcsiPpmCreate desde la función de devolución de llamada de EVT_WDF_DEVICE_PREPARE_HARDWARE .

La estructura pasada en Config contiene información del conector type-C necesaria para crear conectores con la extensión de clase de conector USB Type-C (UcmCx) mediante UcmConnectorCreate y no se pueden obtener de PPM a través de comandos UCSI, como GetCapability o GetConnectorCapability.

La estructura Config también contiene identificadores de conector, que son necesarios para la asignación uno a uno entre conectores USB type-C y puertos USB.

El objeto PPM también es un WDFOBJECT y crea una asociación uno a uno con el identificador WDFDEVICE proporcionado por el controlador cliente.

El objeto PPM está primario en el WDFOBJECT incluso cuando se llama a UcmUcsiPpmCreate pasando WDF_NO_ATTRIBUTES. El marco administra la duración del objeto.

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