Metode IAsyncReader::RequestAllocator (strmif.h)

  • Artikel

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 meminta RequestAllocator alokator selama koneksi pin.

Sintaks

HRESULT RequestAllocator(
  [in]  IMemAllocator        *pPreferred,
  [in]  ALLOCATOR_PROPERTIES *pProps,
  [out] IMemAllocator        **ppActual
);

Parameter

[in] pPreferred

Arahkan ke antarmuka IMemAllocator pada alokator pilihan pin input, atau NULL.

[in] pProps

Menentukan alamat struktur ALLOCATOR_PROPERTIES , yang dialokasikan oleh penelepon. Pemanggil harus mengisi properti alokator apa pun yang diperlukan pin input, dan mengatur anggota yang tersisa ke nol.

[out] ppActual

Alamat variabel yang menerima penunjuk antarmuka IMemAllocator .

Mengembalikan nilai

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode Deskripsi
E_FAIL
 Gagal menginisialisasi alokator.
VFW_E_BADALIGN
 Perataan yang tidak valid ditentukan.
S_OK
 Alokator dikembalikan.

Keterangan

Pin input hilir harus memanggil metode ini selama proses koneksi. Jika pin memiliki alokator pilihan, tentukan di parameter pPreferred . Tentukan persyaratan buffer apa pun, seperti ukuran atau perataan buffer, dalam parameter pProps . Pin output memilih alokator dan mengembalikan pointer ke dalam parameter ppActual .

Pin output tidak diperlukan untuk mematuhi permintaan pin input. Jika pin input memiliki persyaratan absolut, pin input harus memanggil metode IMemAllocator::GetProperties pada alokator yang dikembalikan. Ini dapat gagal menyambungkan jika properti alokator tidak cocok. Setelah koneksi dibuat, pin input harus menggunakan alokator yang dipilih oleh pin output.

Pin input bertanggung jawab untuk melakukan dan menonaktifkan alokator.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header strmif.h (termasuk Dshow.h)
Pustaka Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IAsyncReader