Fungsi UcmUcsiPpmStop (ucmucsippm.h)

  • Artikel

Menginstruksikan ekstensi kelas UcmUcsiCx untuk berhenti mengirim permintaan ke driver klien.

Sintaks

void UcmUcsiPpmStop(
  [in] UCMUCSIPPM PpmObject
);

Parameter

[in] PpmObject

Handel ke objek Manajer Kebijakan Platform (PPM) yang diterima driver klien dalam panggilan sebelumnya ke UcmUcsiPpmCreate.

Nilai kembali

Tidak ada

Keterangan

UcmUcsiPpmStop menunjukkan bahwa driver klien tidak lagi siap untuk menerima permintaan dari ekstensi kelas. Ekstensi kelas menjamin bahwa tidak akan ada permintaan yang dibuat untuk klien setelah panggilan ini kembali. Driver harus memanggil DDI ini ketika mengalami kesalahan dan ingin ekstensi kelas berhenti mengirim permintaan PPM. Setelah panggilan selesai, driver harus memulai PPM lagi menggunakan UcmUcsiPpmStart.

Driver klien diharapkan untuk memanggil DDI ini pada pembongkaran driver. Panggilan ini menunjukkan ekstensi kelas untuk mulai merobek mesin status internalnya. Disarankan agar klien memanggil UcmUcsiPpmStop dari panggilan balik EVT_WDF_DEVICE_RELEASE_HARDWARE.

Karena UcmUcsiPpmStop mengandalkan pengiriman perintah UCSI ke PPM melalui WDFQUEUE yang dikelola daya yang disediakan oleh driver klien, upaya untuk memanggil fungsi ini dari panggilan balik EVT_WDF_DEVICE_D0_EXIT menghasilkan kegagalan. Itu karena saat ini, gerbang pengiriman untuk antrean ditutup.

Setelah UcmUcsiPpmStop kembali, UcmUcsiPpmStart dapat dipanggil untuk memulai PPM lagi.

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