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.
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 |