Metode IDvdInfo2::GetDVDTextStringAsUnicode (strmif.h)

Artikel
07/28/2023

[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 mengambil GetDVDTextStringAsUnicode string teks DVD untuk bahasa tertentu, dan mengembalikan string teks sebagai string Unicode.

Sintaks

HRESULT GetDVDTextStringAsUnicode(
  [in]  ULONG              ulLangIndex,
  [in]  ULONG              ulStringIndex,
  [out] WCHAR              *pchwBuffer,
  [in]  ULONG              ulMaxBufferSize,
  [out] ULONG              *pulActualSize,
  [out] DVD_TextStringType *pType
);

Parameter

[in] ulLangIndex

Indeks bahasa berbasis nol. Untuk menemukan jumlah bahasa string teks di DVD, panggil IDvdInfo2::GetDVDTextNumberOfLanguages.

[in] ulStringIndex

Indeks berbasis nol dari string yang akan diambil. Untuk menemukan jumlah string untuk bahasa tertentu, panggil IDvdInfo2::GetDVDTextLanguageInfo.

[out] pchwBuffer

Penunjuk ke buffer yang menerima string teks. Jika pchBufferADALAH NULL, metode ini mengembalikan ukuran string dalam pulActualSize.

[in] ulMaxBufferSize

Ukuran buffer pchBuffer , dalam WCHAR.

[out] pulActualSize

Menerima panjang string aktual dalam karakter, termasuk NULL yang mengakhiri.

[out] pType

Menerima anggota enumerasi DVD_TextStringType . Nilai menunjukkan jenis string teks, seperti judul film atau nama lagu. Parameter ini juga dapat menerima nilai yang tidak ditentukan dalam enumerasi DVD_TextStringType .

Mengembalikan nilai

Mengembalikan salah satu nilai HRESULT berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_FAIL	Te yang tidak didukung
E_POINTER	Argumen tidak valid.
E_UNEXPECTED	Terjadi kesalahan internal yang tidak terduga.

Keterangan

Metode ini mendukung string teks yang dikodekan sebagai Unicode atau ASCII 7-bit (ISO/IEC 646). Jika string teks menggunakan pengodean ASCII, metode mengonversi string menjadi string karakter lebar. Jika string teks menggunakan kumpulan karakter lainnya, metode akan mengembalikan E_FAIL. Dalam hal ini, Anda dapat memanggil IDvdInfo2::GetDVDTextStringAsNative untuk mengambil string sebagai array byte mentah. Untuk menemukan kumpulan karakter, panggil IDvdInfo2::GetDVDTextLanguageInfo.

String yang dikembalikan selalu menyertakan NULL yang mengakhiri. Jika buffer lebih kecil dari panjang string teks DVD, string akan terpotong. Untuk menemukan ukuran buffer yang diperlukan, panggil metode sekali dengan pchBuffer sama dengan NULL dan ulMaxBufferSize sama dengan nol. Ukuran dikembalikan dalam pulActualSize. Kemudian alokasikan buffer dan panggil metode lagi.

Persyaratan

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

Lihat juga

Aplikasi DVD

Kode Kesalahan dan Keberhasilan

Antarmuka IDvdInfo2

Bekerja dengan String Teks DVD

Bagikan melalui