Metode IMXF::SetState (dmusicks.h)
Metode SetState digunakan untuk mengatur status antarmuka transformasi MIDI.
Sintaks
NTSTATUS SetState(
KSSTATE State
);
Parameter
State
Menentukan status grafik filter yang akan diatur. Parameter ini adalah nilai enumerasi KSSTATE. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
Nilai kembali
Metode ini mengembalikan NTSTATUS yang berisi STATUS_SUCCESS jika panggilan berhasil. Jika tidak, metode mengembalikan kode kesalahan yang sesuai.
Keterangan
Untuk grafik filter audio, empat nilai enumerasi KSSTATE ditafsirkan sebagai berikut:
| Nilai | Provinsi |
|---|---|
| KSSTATE_RUN | Semuanya berjalan dan berfungsi seperti biasa. Dalam status ini, antarmuka IMXF akan aktif dan meneruskan pesan seperti biasa. |
| KSSTATE_ACQUIRE | Ini adalah status transisi yang membantu mengelola transisi antara KSSTATE_RUN dan KSSTATE_STOP. Dalam status ini, pesan tidak dapat diteruskan ke hilir dalam grafik filter. |
| KSSTATE_PAUSE | Ini adalah status transisi yang membantu mengelola transisi antara KSSTATE_RUN dan KSSTATE_STOP. |
| KSSTATE_STOP | Semuanya dihentikan dalam grafik filter saat ini. |
Perilaku driver miniport tergantung pada status grafik filter. Perilaku ini berbeda untuk penyajian (output) dan pengambilan (input).
Di sisi output, jika status saat ini adalah apa pun selain KSSTATE_RUN, antarmuka IMXF harus menyimpan data dan tidak meneruskannya ke perangkat keras. Jika status saat ini KSTATE_STOP maka driver miniport harus membuang data apa pun yang diberikan dengan meneruskan data tersebut ke alokator.
Di sisi input, jika aliran input berada di KSSTATE_RUN atau KSSTATE_PAUSE, legal bagi driver miniport untuk mendapatkan pesan dari alokator dan mengirimnya ke upstream ke sink pengambilan. Jika statusnya KSSTATE_STOP atau KSSTATE_ACQUIRE dan perangkat keras mencoba menghasilkan data, data tersebut harus dibuang.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | dmusicks.h |
| IRQL | PASSIVE_LEVEL |