Função UcmUcsiConnectorCollectionCreate (ucmucsippm.h)
Cria um objeto de coleção de conectores com UcmUcsiCx.
Sintaxe
NTSTATUS UcmUcsiConnectorCollectionCreate(
[in] WDFDEVICE WdfDevice,
[in] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] UCMUCSI_CONNECTOR_COLLECTION *ConnectorCollection
);
Parâmetros
[in] WdfDevice
Um identificador para um objeto de dispositivo de estrutura que o driver cliente recebeu na chamada anterior para WdfDeviceCreate.
[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] ConnectorCollection
Um ponteiro para um local que recebe um identificador para o novo objeto de coleção de conectores.
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
O objeto de coleção é necessário para criar um objeto PPM (Platform Policy Manager). O driver cliente cria o objeto chamando UcmUcsiPpmCreate. O driver não deve chamar [UcmUcsiConnectorCollectionCreate] após ucmUcsiPpmCreate porque não teria efeito sobre o objeto PPM já existente.
O objeto de coleção do conector é pai do WDFOBJECT mesmo quando UcmUcsiConnectorCollectionCreate é 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 |