UcmUcsiConnectorCollectionBuat fungsi (ucmucsippm.h)

Artikel
03/05/2024

Membuat objek koleksi konektor dengan UcmUcsiCx.

Sintaks

NTSTATUS UcmUcsiConnectorCollectionCreate(
  [in]  WDFDEVICE                    WdfDevice,
  [in]  PWDF_OBJECT_ATTRIBUTES       Attributes,
  [out] UCMUCSI_CONNECTOR_COLLECTION *ConnectorCollection
);

Parameter

[in] WdfDevice

Handel ke objek perangkat kerangka kerja yang diterima driver klien dalam panggilan sebelumnya ke WdfDeviceCreate.

[in] Attributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang disediakan penelepon yang berisi atribut untuk objek pengumpulan konektor baru. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.

[out] ConnectorCollection

Penunjuk ke lokasi yang menerima handel ke objek koleksi konektor baru.

Nilai kembali

Mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode ini dapat mengembalikan nilai NTSTATUS yang sesuai.

Keterangan

Objek pengumpulan diperlukan untuk membuat objek Manajer Kebijakan Platform (PPM). Driver klien membuat objek dengan memanggil UcmUcsiPpmCreate. Driver tidak boleh memanggil [UcmUcsiConnectorCollectionCreate] setelah UcmUcsiPpmCreate karena tidak akan berpengaruh pada objek PPM yang sudah ada.

Objek koleksi konektor diinduk ke WDFOBJECT bahkan ketika UcmUcsiConnectorCollectionCreate dipanggil dengan meneruskan WDF_NO_ATTRIBUTES. Masa pakai objek adalah manajer oleh kerangka kerja.