METODE IMFTrackedSample::SetAllocator (mfidl.h)

  • Artikel

Mengatur pemilik untuk sampel.

Sintaks

HRESULT SetAllocator(
  [in] IMFAsyncCallback *pSampleAllocator,
  [in] IUnknown         *pUnkState
);

Parameter

[in] pSampleAllocator

Penunjuk ke antarmuka IMFAsyncCallback dari objek panggilan balik. Pemanggil harus mengimplementasikan antarmuka ini.

[in] pUnkState

Penunjuk ke antarmuka IUnknown dari objek status, yang ditentukan oleh pemanggil. Parameter ini bisa NULL. Anda dapat menggunakan objek ini untuk menyimpan informasi status. Objek dikembalikan ke pemanggil ketika panggilan balik dipanggil.

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.
MF_E_NOTACCEPTING
 Pemilik sudah ditetapkan. Metode ini tidak dapat dipanggil dua kali pada sampel.

Keterangan

Ketika metode ini dipanggil, sampel menyimpan jumlah referensi tambahan pada dirinya sendiri. Ketika setiap objek lain merilis jumlah referensinya pada sampel, sampel memanggil metode panggilan balik pSampleAllocator . Untuk mendapatkan penunjuk ke sampel, panggil IMFAsyncResult::GetObject pada objek hasil asinkron yang diberikan ke metode IMFAsyncCallback::Invoke callback.

Setelah panggilan balik dipanggil, sampel akan menghapus panggilan balik. Untuk mengembalikan panggilan balik, Anda harus memanggil SetAllocator lagi.

Aman untuk meneruskan penunjuk antarmuka IMFSample sampel sebagai objek status (pUnkState) untuk panggilan balik. Jika pUnkState menunjuk ke sampel, metode SetAllocator memperhitungkan jumlah referensi tambahan pada pUnkState.

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 mfidl.h
Pustaka Strmiids.lib

Lihat juga

IMFTrackedSample