Fungsi UcmConnectorPowerDirectionChanged (ucmmanager.h)

  • Artikel

Memberi tahu ekstensi kerangka kerja manajer konektor USB (UcmCx) dengan peran daya baru konektor mitra.

Sintaks

void UcmConnectorPowerDirectionChanged(
  [in] UCMCONNECTOR   Connector,
  [in] BOOLEAN        Success,
  [in] UCM_POWER_ROLE CurrentPowerRole
);

Parameter

[in] Connector

Tangani ke objek konektor yang diterima driver klien dalam panggilan sebelumnya ke UcmConnectorCreate.

[in] Success

Digunakan untuk menunjukkan kegagalan pertukaran peran daya yang dimulai oleh UcmCx menggunakan EVT_UCM_CONNECTOR_SET_POWER_ROLE.

Jika TRUE, operasi berhasil. FALSE, jika tidak.

[in] CurrentPowerRole

Salah satu bendera berjenis UCM_POWER_ROLE yang menunjukkan peran data baru.

Nilai kembali

Tidak ada

Keterangan

UcmConnectorPowerDirectionChanged mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi sebaris ini dapat mengembalikan nilai NTSTATUS yang sesuai.

Jika mitra konektor terpasang, UcmCx memperbarui peran daya mitra tergantung pada nilai CurrentPowerRole .

UcmCx dapat mengubah peran daya konektor, dan memanggil EVT_UCM_CONNECTOR_SET_POWER_ROLE. Menanggapi panggilan itu, klien harus melakukan operasi PR_Swap, dan menunjukkan keberhasilan/kegagalan operasi dengan memanggil UcmConnectorPowerDirectionChanged.

Atau, driver klien mungkin memilih untuk melakukan pertukaran peran secara otonom, atau mitra mungkin melakukan pertukaran peran. Dalam kedua kasus, ketika pertukaran peran telah selesai, driver harus melaporkan peran baru ke UcmCx menggunakan UcmConnectorPowerDirectionChanged.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10
Server minimum yang didukung Server Windows 2016
Target Platform Windows
Versi KMDF minimum 1.15
Versi UMDF minimum 2.15
Header ucmmanager.h (termasuk Ucmcx.h)
Pustaka UcmCxstub.lib
IRQL PASSIVE_LEVEL

Lihat juga