Metode IPropertySetter::GetProps

[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.]

Catatan

[Tidak digunakan lagi. API ini bisa dihapus dari rilis Windows mendatang.]

 

Metode mengambil GetProps properti yang diatur pada objek ini, dengan nilai yang sesuai.

Sintaks

HRESULT GetProps(
  [out] LONG         *pcParams,
  [out] DEXTER_PARAM **paParam,
  [out] DEXTER_VALUE **paValue
);

Parameter

pcParams [out]

Menerima jumlah struktur yang dikembalikan di paParam.

paParam [keluar]

Alamat penunjuk ke array struktur DEXTER_PARAM .

paValue [out]

Alamat penunjuk ke array struktur DEXTER_VALUE .

Nilai kembali

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Untuk setiap properti yang dikembalikan di paParam, anggota nValues menunjukkan jumlah struktur DEXTER_VALUE yang terkait dengan properti . Pasangan dikembalikan dalam urutan waktu naik untuk setiap properti.

Ketika Anda selesai menggunakan struktur yang dikembalikan, panggil IPropertySetter::FreeProps untuk membebaskan sumber daya yang dialokasikan oleh metode ini.

Catatan

File header Qedit.h tidak kompatibel dengan header Direct3D yang lebih baru dari versi 7.

 

Catatan

Untuk mendapatkan Qedit.h, unduh Microsoft Windows SDK Update untuk Windows Vista dan .NET Framework 3.0. Qedit.h tidak tersedia di Microsoft Windows SDK untuk Windows 7 dan .NET Framework 3.5 Service Pack 1.

 

Contoh

Contoh kode berikut menunjukkan cara melakukan iterasi melalui semua nilai pada instans setter properti:

IPropertySetter *pSetter = NULL;
// Get a valid IPropertySetter pointer (not shown).

DEXTER_PARAM *pParam;
DEXTER_VALUE *pValue;
LONG count;

hr = pSetter->GetProps(&count, &pParam, &pValue);

LONG num = 0;
for (LONG i = 0; i < count; i++)
{
    for (LONG j = 0; j < pParam[i].nValues; j++)
    {
        // pValue[num] is the next value in the sequence for pParam[i]
    }
    num += pParam[i].nValues;
}

Persyaratan

Persyaratan	Nilai
Header	Qedit.h
Pustaka	Strmiids.lib

Lihat juga

Antarmuka IPropertySetter

Kode Kesalahan dan Keberhasilan