METODE IMFAsyncCallback::GetParameters (mfobjects.h)

Menyediakan informasi konfigurasi ke utas pengiriman untuk panggilan balik.

Syntax

HRESULT GetParameters(
  [out] DWORD *pdwFlags,
  [out] DWORD *pdwQueue
);

Parameter-parameternya

[out] pdwFlags

Menerima bendera yang menunjukkan perilaku metode IMFAsyncCallback::Invoke objek panggilan. Nilai berikut ditentukan. Nilai defaultnya adalah nol.

Nilai Meaning
Nol
 Panggilan balik tidak membutuhkan waktu lama untuk diselesaikan, tetapi tidak memiliki batasan khusus pada panggilan sistem apa yang dilakukannya. Panggilan balik umumnya membutuhkan waktu kurang dari 30 milidetik untuk diselesaikan.
MFASYNC_FAST_IO_PROCESSING_CALLBACK
 Panggilan balik melakukan pemrosesan yang sangat minimal. Dibutuhkan kurang dari 1 milidetik untuk diselesaikan.

Panggilan balik harus dipanggil dari salah satu antrean kerja berikut:

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_SIGNAL_CALLBACK
 Menyiratkan MFASYNC_FAST_IO_PROCESSING_CALLBACK, dengan batasan tambahan bahwa panggilan balik tidak memproses (kurang dari 50 mikrodetik), dan satu-satunya panggilan sistem yang dilakukannya adalah SetEvent.

Panggilan balik harus dipanggil dari salah satu antrean kerja berikut:

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_BLOCKING_CALLBACK
 Memblokir panggilan balik.
MFASYNC_REPLY_CALLBACK
 Balas panggilan balik.

[out] pdwQueue

Menerima pengidentifikasi antrean kerja tempat panggilan balik dikirim.

Nilai ini dapat menentukan salah satu antrean kerja Media Foundation standar, atau antrean kerja yang dibuat oleh aplikasi. Untuk daftar antrean kerja Media Foundation standar, lihat Pengidentifikasi Antrean Kerja. Untuk membuat antrean kerja baru, panggil MFAllocateWorkQueue. Nilai defaultnya adalah MFASYNC_CALLBACK_QUEUE_STANDARD.

Jika antrean kerja tidak kompatibel dengan nilai yang dikembalikan dalam pdwFlags, platform Media Foundation mengembalikan MF_E_INVALID_WORKQUEUE ketika mencoba mengirimkan panggilan balik. (Lihat MFPutWorkItem.)

Mengembalikan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Mengembalikan kode Description
S_OK
 Metode berhasil.
E_NOTIMPL
 Tidak diterapkan. Asumsikan perilaku default.

Komentar

Metode GetParameters mengembalikan informasi tentang panggilan balik sehingga utas pengiriman dapat mengoptimalkan proses yang digunakannya untuk memanggil panggilan balik.

Jika metode mengembalikan nilai selain nol dalam parameter pdwFlags , metode Invoke Anda harus memenuhi persyaratan yang dijelaskan di sini. Jika tidak, panggilan balik mungkin menunda alur.

Jika Anda menginginkan nilai default untuk kedua parameter, kembalikan E_NOTIMPL. Nilai default diberikan dalam deskripsi parameter di halaman ini.

Antarmuka ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:

  • Windows XP dengan Paket Layanan 2 (SP2) dan yang lebih baru.
  • Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Platform Target Windows
Header mfobjects.h (termasuk Mfidl.h)
Library Mfuuid.lib

Lihat juga

Metode Panggilan Balik Asinkron

IMFAsyncCallback

Antrean Kerja

  • Last updated on