METODE IMFAsyncCallback::GetParameters (mfobjects.h)

Artikel
08/24/2023

Menyediakan informasi konfigurasi ke utas pengiriman untuk panggilan balik.

Sintaks

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

Parameter

[out] pdwFlags

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

Nilai	Makna
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 menyelesaikannya. 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 melakukan pemrosesan (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.)

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_NOTIMPL	Tidak diterapkan. Asumsikan perilaku default.

Keterangan

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]
Target Platform	Windows
Header	mfobjects.h (termasuk Mfidl.h)
Pustaka	Mfuuid.lib

Lihat juga

Metode Panggilan Balik Asinkron

IMFAsyncCallback

Antrean Kerja

Bagikan melalui