Fungsi UcmTcpciPortControllerStop (ucmtcpciportcontroller.h)

  • Artikel

Menunjukkan ekstensi kelas UcmTcpciCx untuk berhenti mengirim permintaan perangkat keras ke objek pengontrol port.

Sintaks

void UcmTcpciPortControllerStop(
  UCMTCPCIPORTCONTROLLER PortControllerObject
);

Parameter

PortControllerObject

Tangani ke objek pengontrol port yang diterima driver klien di panggilan sebelumnya ke UcmTcpciPortControllerCreate.

Nilai kembali

Tidak ada

Keterangan

Setelah memanggil UcmTcpciPortControllerStop, driver klien berhenti memproses semua permintaan pada objek pengontrol port. Panggilan ini sinkron, sehingga dijamin bahwa ekstensi kelas tidak akan memanggil fungsi panggilan balik atau mengirim permintaan setelah kembali. Driver tidak boleh memanggil metode ini dalam panggilan balik pengontrol port, atau ketika permintaan perangkat keras yang tidak dapat dibatalkan tertunda.

Driver klien memanggil metode ini dari implementasi panggilan balik EVT_WDF_DEVICE_RELEASE_HARDWARE . Setelah melakukannya, itu juga harus memanggil WdfObjectDelete, jika EVT_WDF_DEVICE_RELEASE_HARDWARE dipanggil ke penyeimbangan ulang sumber daya. Kegagalan untuk melakukannya menyebabkan driver membocorkan objek yang terkait dengan objek pengontrol port ketika penyeimbangan ulang sumber daya terjadi. Mengasuh handel UCMPORTCONTROLLER ke handel WDFDEVICE tidak cukup, karena WDFDEVICE tidak dihapus di seluruh penyeimbangan ulang sumber daya.

Jika driver beralih ke status Dx karena S0-Idle, driver tidak boleh memanggil metode ini dari fungsi panggilan balik EVT_WDF_DEVICE_D0_EXIT . Sinkronisasi dengan status daya driver dapat dicapai dengan menggunakan antrean yang dikelola daya untuk menerima permintaan perangkat keras.

Aman untuk memanggil UcmTcpciPortControllerStop pada pengontrol port yang telah dihentikan. Setelah metode ini kembali, tidak ada metode lain kecuali untuk UcmTcpciPortControllerStart yang dapat dipanggil pada pengontrol port.

Driver klien harus memanggil metode ini jika perlu menghentikan semua tindakan pada pengontrol port sehingga dapat melakukan pemulihan kesalahan jika mendeteksi masalah selama operasinya. Setelah proses pemulihan selesai, driver harus memulai ulang pengontrol port.

Menghentikan pengontrol mengakhiri kontrak PD aktif dan koneksi Type-C.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10
Server minimum yang didukung Server Windows 2016
Target Platform Windows
Header ucmtcpciportcontroller.h
Pustaka Ucmtcpcicxstub.lib
IRQL PASSIVE_LEVEL

Lihat juga

UcmTcpciPortControllerStart