Fungsi UcmConnectorDataDirectionChanged (ucmmanager.h)

  • Artikel

Memberi tahu ekstensi kerangka kerja manajer konektor USB (UcmCx) dengan peran data baru tentang perubahan peran data.

Sintaks

void UcmConnectorDataDirectionChanged(
  [in] UCMCONNECTOR  Connector,
  [in] BOOLEAN       Success,
  [in] UCM_DATA_ROLE CurrentDataRole
);

Parameter

[in] Connector

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

[in] Success

Digunakan untuk menunjukkan kegagalan pertukaran peran data yang dimulai oleh UcmCx menggunakan EVT_UCM_CONNECTOR_SET_DATA_ROLE.

Jika TRUE, operasi berhasil. FALSE, jika tidak.

[in] CurrentDataRole

Nilai UCM_TYPEC_PARTNER yang menunjukkan peran data baru.

Nilai kembali

Tidak ada

Keterangan

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

Jika mitra konektor terpasang, UcmCx memperbarui peran data mitra tergantung pada nilai CurrentDataRole . Misalnya, jika driver klien mengubah peran data menjadi UcmTypeCPortStateUfp, UcmCx memperbarui peran mitra konektor ke UcmTypeCPortStateDfp.

UcmCx dapat mengubah peran data konektor, dan memanggil EVT_UCM_CONNECTOR_SET_DATA_ROLE. Menanggapi panggilan tersebut, klien harus melakukan operasi DR_Swap, dan menunjukkan keberhasilan/kegagalan operasi dengan memanggil UcmConnectorDataDirectionChanged.

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 UcmConnectorDataDirectionChanged.

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