IDvdInfo2::GetDVDTextStringAsNative-Methode (strmif.h)

Artikel
03/06/2024

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die GetDVDTextStringAsNative -Methode ruft eine DVD-Textzeichenfolge für eine angegebene Sprache ab und gibt die Textzeichenfolge als Array von Bytes zurück.

Syntax

HRESULT GetDVDTextStringAsNative(
  [in]  ULONG              ulLangIndex,
  [in]  ULONG              ulStringIndex,
  [out] BYTE               *pbBuffer,
  [in]  ULONG              ulMaxBufferSize,
  [out] ULONG              *pulActualSize,
  [out] DVD_TextStringType *pType
);

Parameter

[in] ulLangIndex

Nullbasierter Index der Sprache. Um die Anzahl der Textzeichenfolgensprachen auf der DVD zu ermitteln, rufen Sie IDvdInfo2::GetDVDTextNumberOfLanguages auf.

[in] ulStringIndex

Nullbasierter Index der abzurufenden Zeichenfolge. Um die Anzahl der Zeichenfolgen für eine bestimmte Sprache zu ermitteln, rufen Sie IDvdInfo2::GetDVDTextLanguageInfo auf.

[out] pbBuffer

Zeiger auf einen Puffer, der die Textzeichenfolge empfängt. Wenn pchBufferNULL ist, gibt diese Methode die Größe der Zeichenfolge in pulActualSize zurück.

[in] ulMaxBufferSize

Größe des pchBuffer in Byte

[out] pulActualSize

Empfängt die tatsächliche Länge der Zeichenfolge in Bytes, einschließlich der endenden NULL.

[out] pType

Empfängt einen Member der DVD_TextStringType-Enumeration . Der Wert gibt den Typ der Textzeichenfolge an, z. B. Filmtitel oder Songname. Dieser Parameter kann auch Werte empfangen, die nicht in der DVD_TextStringType-Enumeration definiert sind.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Ungültiges Argument.
E_UNEXPECTED	Es ist ein unerwarteter Fehler aufgetreten.

Hinweise

Diese Methode gibt eine DVD-Textzeichenfolge als unformatiertes Bytearray ohne Konvertierungen zurück. Sie können diese Methode verwenden, um Textzeichenfolgen abzurufen, die mit anderen Zeichensätzen als Unicode oder 7-Bit-ASCII (ISO/IEC 646) codiert sind, z. B. JIS Roman Kanji. Rufen Sie zum Ermitteln des Zeichensatzes IDvdInfo2::GetDVDTextLanguageInfo auf.

Für Unicode- und ASCII-Textzeichenfolgen können Sie die IDvdInfo2::GetDVDTextStringAsUnicode-Methode verwenden, die eine Breitzeichenzeichenfolge zurückgibt.

Die zurückgegebene Zeichenfolge enthält immer ein einzelnes beendendes NULL-Byte . Wenn der Puffer kleiner als die Länge der DVD-Textzeichenfolge ist, wird die Zeichenfolge abgeschnitten. Um die erforderliche Größe des Puffers zu ermitteln, rufen Sie die -Methode einmal mit pchBuffer gleich NULL und ulMaxBufferSize gleich 0 auf. Die Größe wird in pulActualSize zurückgegeben. Ordnen Sie dann einen Puffer zu, und rufen Sie die Methode erneut auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

DVD-Anwendungen

Fehler- und Erfolgscodes

IDvdInfo2-Schnittstelle

Arbeiten mit DVD-Textzeichenfolgen

Freigeben über