Metode IAsyncReader::RequestAllocator (strmif.h)

Artikel
03/04/2024

[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

Bagikan melalui