fungsi UsbPm_AssignConnectorPowerLevel (usbpmapi.h)

  • Artikel

Mencoba negosiasi ulang kontrak PD dengan tegangan/nilai arus/daya yang ditentukan.

Sintaks

NTSTATUS UsbPm_AssignConnectorPowerLevel(
  [In] USBPM_CLIENT                               ClientHandle,
  [In] USBPM_CONNECTOR                            ConnectorHandle,
  [In] PUSBPM_ASSIGN_CONNECTOR_POWER_LEVEL_PARAMS Params
);

Parameter

[In] ClientHandle

Handel yang diterima driver klien dalam panggilan sebelumnya ke UsbPm_Register.

[In] ConnectorHandle

Handel konektor yang disediakan oleh Policy Manager saat memanggil implementasi driver EVT_USBPM_EVENT_CALLBACK. Handel diatur dalam anggota EventData.ConnectorStateChange.ConnectorHandle dari nilai Params .

[In] Params

Penunjuk ke struktur USBPM_ASSIGN_CONNECTOR_POWER_LEVEL_PARAMS yang disediakan pengemudi yang berisi tegangan/arus/nilai daya untuk bernegosiasi. Inisialisasi struktur dengan memanggil USBPM_ASSIGN_CONNECTOR_POWER_LEVEL_PARAMS_INIT.

Menentukan 0 sebagai tegangan/nilai arus/daya untuk konektor dalam peran power sink menyebabkan konektor berhenti mengisi daya.

Menampilkan nilai

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

Keterangan

Pengaturan yang dinegosiasikan hanya persisten selama mitra port terpasang, dan dibuang ketika mitra port dilepas. Driver klien diperlukan untuk memanggil fungsi ini berdasarkan status konektor saat ini, tanpa mengasumsikan pengaturan sebelumnya.

Jika panggilan ini berhasil, permintaan telah diterima tetapi negosiasi ulang kontrak PD mungkin tidak selesai. Hasil dari negosiasi ulang kontrak PD dapat berupa keberhasilan atau kegagalan.

Sebagai hasil dari negosiasi ulang kontrak PD yang berhasil, EVT_USBPM_EVENT_CALLBACK dipanggil dengan peristiwa perubahan status konektor. Jika permintaan negosiasi ulang kontrak PD gagal, fungsi panggilan balik tidak dipanggil. Misalnya, permintaan ditolak oleh mitra, atau tidak lagi valid karena status konektor telah berubah.
Dalam Windows 10, versi 1809, driver hanya dapat memanggil fungsi ini dengan peran daya UsbCPowerRoleSink dan ketika mitra melekat pada konektor.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, version 1809
Versi KMDF minimum 1.27
Versi UMDF minimum 2.27
Header usbpmapi.h
Pustaka UsbPmApi.lib
IRQL PASSIVE_LEVEL

Lihat juga

UsbPm_Register

EVT_USBPM_EVENT_CALLBACK