Metode IPin::QueryId (strmif.h)

[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 ini QueryId mengambil pengidentifikasi untuk pin.

Sintaks

HRESULT QueryId(
  [out] LPWSTR *Id
);

Parameter

[out] Id

Menerima string yang berisi pengidentifikasi pin.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_OUTOFMEMORY	Memori tidak cukup.
E_POINTER	Argumen pointer NULL.

Keterangan

Metode ini mendukung persistensi grafik. Gunakan metode ini untuk menyimpan status pin, dan metode IBaseFilter::FindPin untuk memulihkan status. String pengidentifikasi pin ditentukan oleh implementasi filter. Pengidentifikasi harus unik dalam filter.

CatatanPengidentifikasi pin belum tentu sama dengan nama pin yang dikembalikan metode QueryPinInfo .

 

Filter mengalokasikan string yang dikembalikan menggunakan fungsi CoTaskMemAlloc . Pemanggil harus membebaskannya menggunakan CoTaskMemFree.

Persyaratan

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

Aliran Data di Grafik Filter

Kode Kesalahan dan Keberhasilan

Antarmuka IPin