Metode CCmdQueue.New

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode New ini menginisialisasi perintah yang akan dijalankan dan mengembalikan objek CDeferredCommand baru.

Sintaks

virtual HRESULT New(
   CDeferredCommand **ppCmd,
   LPUNKNOWN        pUnk,
   REFTIME          time,
   GUID             *iid,
   long             dispidMethod,
   short            wFlags,
   long             cArgs,
   VARIANT          *pDispParams,
   VARIANT          *pvarResult,
   short            *puArgErr,
   BOOL             bStream
);

Parameter

ppCmd

Alamat penunjuk ke objek CDeferredCommand tempat aplikasi dapat membatalkan perintah, mengatur waktu presentasi baru untuknya, atau mengambil informasi perkiraan.

Punk

Penunjuk ke objek yang akan menjalankan perintah.

waktu

Waktu untuk menjalankan perintah atau perintah yang diantrekan.

iid

Arahkan ke pengidentifikasi unik global (GUID) antarmuka yang akan dipanggil.

dispidMethod

Metode pada antarmuka yang akan dipanggil.

wFlags

Bendera yang menjelaskan konteks panggilan. Parameter ini mendukung bendera yang sama dengan metode IDispatch::Invoke .

cArgs

Jumlah argumen yang diteruskan.

pDispParams

Arahkan ke daftar jenis varian yang terkait dengan parameter pengiriman.

pvarResult

Arahkan ke daftar di mana hasil, jika ada, akan dikembalikan.

puArgErr

Arahkan ke indeks dalam daftar parameter pDispParams tempat kesalahan terakhir terjadi.

bStream

Nilai yang menunjukkan apakah parameter waktu adalah nilai waktu aliran (TRUE) atau nilai waktu presentasi (FALSE).

Mengembalikan nilai

Mengembalikan S_OK jika berhasil. Mengembalikan E_OUTOFMEMORY jika ppCmd kembali dari pembuatan objek CDeferredCommand baru dengan nilai NULL. Jika tidak, mengembalikan HRESULT yang menunjukkan kesalahan dari upaya membuat objek CDeferredCommand baru. Jika ada kesalahan, tidak ada objek yang diantrekan.

Keterangan

Objek CDeferredCommand baru akan diinisialisasi dengan parameter dan akan ditambahkan ke antrean selama konstruksi. Metode ini mirip dengan metode IDispatch::Invoke .

Nilai untuk parameter wFlags meliputi yang berikut:

Nilai Deskripsi
DISPATCH_METHOD Anggota sedang dijalankan sebagai metode. Jika properti memiliki nama yang sama, bendera ini dan DISPATCH_PROPERTYGET dapat diatur.
DISPATCH_PROPERTYGET Anggota sedang diambil sebagai properti atau anggota data.
DISPATCH_PROPERTYPUT Anggota sedang diubah sebagai properti atau anggota data.
DISPATCH_PROPERTYPUTREF Anggota sedang diubah melalui penetapan referensi, bukan penetapan nilai. Nilai ini hanya valid ketika properti menerima referensi ke objek.

Persyaratan

Persyaratan Nilai
Header
Winutil.h (termasuk Streams.h)
Pustaka
Strmbase.lib (build ritel);
Strmbasd.lib (build debug)

Lihat juga

Kelas CCmdQueue

  • Last updated on