IDvdInfo2::GetDVDTextStringAsUnicode-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die GetDVDTextStringAsUnicode -Methode ruft eine DVD-Textzeichenfolge für eine angegebene Sprache ab und gibt die Textzeichenfolge als Unicode-Zeichenfolge zurück.

Syntax

HRESULT GetDVDTextStringAsUnicode(
  [in]  ULONG              ulLangIndex,
  [in]  ULONG              ulStringIndex,
  [out] WCHAR              *pchwBuffer,
  [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] pchwBuffer

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-Puffers in WCHARs.

[out] pulActualSize

Empfängt die tatsächliche Länge der Zeichenfolge in Zeichen, einschließlich des beendenden NULL.

[out] pType

Empfängt ein Element 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_FAIL	Nicht unterstützt te
E_POINTER	Ungültiges Argument.
E_UNEXPECTED	Es ist ein unerwarteter Fehler aufgetreten.

Hinweise

Diese Methode unterstützt Textzeichenfolgen, die als Unicode oder 7-Bit-ASCII (ISO/IEC 646) codiert sind. Wenn die Textzeichenfolge ASCII-Codierung verwendet, konvertiert die -Methode die Zeichenfolge in eine Breitzeichenzeichenfolge. Wenn die Textzeichenfolge einen anderen Zeichensatz verwendet, gibt die Methode E_FAIL zurück. In diesem Fall können Sie IDvdInfo2::GetDVDTextStringAsNative aufrufen, um die Zeichenfolge als unformatiertes Bytearray abzurufen. Um den Zeichensatz zu finden, rufen Sie IDvdInfo2::GetDVDTextLanguageInfo auf.

Die zurückgegebene Zeichenfolge enthält immer eine beendende NULL. 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