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

Lihat juga

IMXF