Função UcmUcsiPpmCreate (Ucmucsippm.h)

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.

Retornar valor

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

Comentários

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

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

A estrutura Config também contém IDs de conector, que são necessárias para mapeamento um-para-um entre conectores USB Tipo 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/D
Cabeçalho	Ucmucsippm.h (inclua UcmUcsiCx.h)
Biblioteca	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL