Função UcmUcsiPpmCreate (Ucmucsippm.h)

Artigo
02/07/2025

Cria um objeto PPM (Platform Policy Manager).

Sintaxe

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

Parâmetros

[in] WdfDevice

Um identificador para um objeto de dispositivo de estrutura que o driver cliente recebeu na chamada anterior para WdfDeviceCreate.

[in] Config

Um ponteiro para uma estrutura de UCMUCSI_PPM_CONFIG fornecida pelo chamador que é inicializada chamando UCMUCSI_PPM_CONFIG_INIT. O membro ConnectorCollectionHandle deve ser definido como o identificador recuperado em uma chamada anterior para UcmUcsiConnectorCollectionCreate.

[in] Attributes

Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES fornecida pelo chamador que contém atributos para o novo objeto de coleção de conectores. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[out] PPMObject

Um ponteiro para um local que recebe um identificador para o novo objeto PPM.

Valor de retorno

Retorna STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um valor de NTSTATUS apropriado.

Observações

Espera-se que o driver cliente chame UcmUcsiPpmCreate da função de retorno de chamada EVT_WDF_DEVICE_PREPARE_HARDWARE.

A estrutura passada em de Configuração contém Type-C informações do conector necessárias para a criação de conectores com a ucmCx (extensão de classe do conector) de Type-C USB usando ucmConnectorCreate e não podem ser obtidas do PPM por meio de comandos UCSI, como GetCapability ou GetConnectorCapability.

A estrutura de de configuração também contém IDs do conector, que são necessárias para mapeamento um-para-um entre conectores usb Type-C e portas USB.

O objeto PPM também é um WDFOBJECT e cria uma associação um-para-um com o identificador WDFDEVICE fornecido pelo driver cliente.

O objeto PPM é pai do WDFOBJECT mesmo quando UcmUcsiPpmCreate é chamado passando WDF_NO_ATTRIBUTES. O tempo de vida do objeto é gerenciador pela estrutura.

Requisitos

Requisito	Valor
versão mínima do KMDF	1.27
versão mínima do UMDF	N/A
cabeçalho	Ucmucsippm.h (inclua UcmUcsiCx.h)
biblioteca	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL

Compartilhar via