Metode IDvdInfo2::GetDVDTextStringAsNative (strmif.h)

Artikel
03/04/2024

[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 GetDVDTextStringAsNative string teks DVD untuk bahasa tertentu, dan mengembalikan string teks sebagai array byte.

Sintaks

HRESULT GetDVDTextStringAsNative(
  [in]  ULONG              ulLangIndex,
  [in]  ULONG              ulStringIndex,
  [out] BYTE               *pbBuffer,
  [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] pbBuffer

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

[in] ulMaxBufferSize

Ukuran pchBuffer dalam byte

[out] pulActualSize

Menerima panjang string aktual dalam byte, 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_POINTER	Argumen tidak valid.
E_UNEXPECTED	Terjadi kesalahan internal yang tidak terduga.

Keterangan

Metode ini mengembalikan string teks DVD sebagai array byte mentah, tanpa konversi. Anda dapat menggunakan metode ini untuk mendapatkan string teks yang dikodekan menggunakan set karakter selain Unicode atau ASCII 7-bit (ISO/IEC 646), seperti JIS Roman Kanji. Untuk menemukan kumpulan karakter, panggil IDvdInfo2::GetDVDTextLanguageInfo.

Untuk string teks Unicode dan ASCII, Anda dapat menggunakan metode IDvdInfo2::GetDVDTextStringAsUnicode , yang mengembalikan string karakter lebar.

String yang dikembalikan selalu menyertakan satu byte 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