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.

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

O objeto de coleção é necessário para criar um objeto PPM (Platform Policy Manager). O driver do 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/D
Cabeçalho	ucmucsippm.h (inclua UcmUcsiCx.h)
Biblioteca	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL

Confira também

WdfDeviceCreate

WDF_OBJECT_ATTRIBUTES

UcmUcsiPpmCreate

UcmUcsiConnectorCollectionAddConnector