IMiniportWaveCyclicStream::Metode SetState (portcls.h)

  • Artikel

Metode SetState ini mengatur status baru pemutaran atau perekaman untuk aliran.

Sintaks

NTSTATUS SetState(
  [in] KSSTATE State
);

Parameter

[in] State

Menentukan status baru untuk aliran. Parameter ini adalah nilai enumerasi KSSTATE . Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Nilai kembali

SetState mengembalikan 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:

  • KSSTATE_RUN

    Transportasi data dalam grafik filter audio saat ini berjalan dan berfungsi seperti biasa.

  • KSSTATE_ACQUIRE

    Ini adalah status transisi yang membantu mengelola transisi antara KSSTATE_RUN dan KSSTATE_STOP.

  • KSSTATE_PAUSE

    Ini adalah status transisi yang membantu mengelola transisi antara KSSTATE_RUN dan KSSTATE_STOP.

  • KSSTATE_STOP

    Transportasi data dihentikan dalam grafik filter audio saat ini.

Untuk sebagian besar pengemudi miniport, KSSTATE_ACQUIRE dan KSSTATE_PAUSE tidak dapat dibedakan.

Transisi selalu terjadi di salah satu dari dua urutan berikut:

  • STOP -> ACQUIRE -> PAUSE -> RUN
  • RUN -> JEDA -> ACQUIRE -> STOP
Metode IMiniportWaveCyclic::NewStream mengatur status awal aliran ke KSSTATE_STOP.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header portcls.h (termasuk Portcls.h)
IRQL PASSIVE_LEVEL

Lihat juga

IMiniportWaveCyclic::NewStream

IMiniportWaveCyclicStream

KSPROPERTY_CONNECTION_STATE

KSSTATE