Fungsi UcmUcsiPpmCreate (Ucmucsippm.h)

  • Artikel

Membuat objek Manajer Kebijakan Platform (PPM).

Sintaks

NTSTATUS UcmUcsiPpmCreate(
  [in]  WDFDEVICE              WdfDevice,
  [in]  PUCMUCSI_PPM_CONFIG    Config,
  [in]  PWDF_OBJECT_ATTRIBUTES Attributes,
  [out] UCMUCSIPPM             *PPMObject
);

Parameter

[in] WdfDevice

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

[in] Config

Penunjuk ke struktur UCMUCSI_PPM_CONFIG yang disediakan penelepon yang diinisialisasi dengan memanggil UCMUCSI_PPM_CONFIG_INIT. Anggota ConnectorCollectionHandle harus diatur ke handel yang diambil dalam panggilan sebelumnya ke UcmUcsiConnectorCollectionCreate.

[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] PPMObject

Penunjuk ke lokasi yang menerima handel ke objek PPM baru.

Nilai kembali

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

Keterangan

Driver klien diharapkan untuk memanggil UcmUcsiPpmCreate dari fungsi panggilan balik EVT_WDF_DEVICE_PREPARE_HARDWARE .

Struktur yang diteruskan dalam Konfigurasi berisi informasi konektor Type-C yang diperlukan untuk membuat konektor dengan ekstensi kelas konektor USB Type-C (UcmCx) dengan menggunakan UcmConnectorCreate dan tidak dapat diperoleh dari PPM melalui perintah UCSI seperti GetCapability atau GetConnectorCapability.

Struktur Konfigurasi juga berisi ID konektor, yang diperlukan untuk pemetaan satu-ke-satu antara konektor USB Type-C dan port USB.

Objek PPM juga merupakan WDFOBJECT dan membuat asosiasi satu-ke-satu dengan handel WDFDEVICE yang disediakan oleh driver klien.

Objek PPM diinduk ke WDFOBJECT bahkan ketika UcmUcsiPpmCreate dipanggil dengan melewati WDF_NO_ATTRIBUTES. Masa pakai objek adalah manajer oleh kerangka kerja.

Persyaratan

Persyaratan Nilai
Versi KMDF minimum 1.27
Versi UMDF minimum T/A
Header Ucmucsippm.h (termasuk UcmUcsiCx.h)
Pustaka UcmUcsiCxStub.lib
IRQL PASSIVE_LEVEL