Freigeben über

IDvdInfo::GetRoot-Methode (strmif.h)

  • Artikel

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

Hinweis Die IDvdInfo-Schnittstelle ist veraltet. Verwenden Sie stattdessen IDvdInfo2 .
 
Ruft das Stammverzeichnis ab, das im Player festgelegt ist.

Syntax

HRESULT GetRoot(
  [out] LPSTR pRoot,
  [in]  ULONG ulBufSize,
  [out] ULONG *pulActualSize
);

Parameter

[out] pRoot

Zeiger auf den Puffer, um die Stammzeichenfolge zu empfangen. Beachten Sie, dass die Stammzeichenfolge ANSI-Zeichen verwendet.

[in] ulBufSize

Größe des übergebenen Puffers in Bytes.

[out] pulActualSize

Zeiger auf einen Wert, der die Größe der tatsächlich zurückgegebenen Daten enthält.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Rückgabecode Beschreibung
E_UNEXPECTED
 Die DVD wird nicht initialisiert, oder die Domäne ist nicht DVD_DOMAIN_Title.
S_OK
 Erfolg.
VFW_E_DVD_INVALIDDOMAIN
 Die angeforderte Aktion wird für diese Domäne (DVD_DOMAIN) nicht unterstützt.
VFW_E_DVD_OPERATION_INHIBITED
 Die angeforderte Aktion kann an dieser Stelle im Film aufgrund der Erstellung des aktuellen DVD-Video Datenträgers nicht ausgeführt werden.

Hinweise

Wenn ein gültiger Stamm gefunden wurde, gibt diese Methode die Stammzeichenfolge zurück. Andernfalls wird null für pcbActualSize zurückgegeben, was angibt, dass kein gültiges Stammverzeichnis gefunden oder initialisiert wurde.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)

Weitere Informationen

Fehler- und Erfolgscodes

IDvdInfo-Schnittstelle