IDvdInfo2::GetDiscID-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 GetDiscID -Methode ruft eine systemgenerierte 64-Bit-Identifikationsnummer für die angegebene DVD ab.
Syntax
HRESULT GetDiscID(
[in] LPCWSTR pszwPath,
[out] ULONGLONG *pullDiscID
);
Parameter
[in] pszwPath
Pfad des Volumes, das für die Datenträger-ID verwendet werden soll. Geben Sie NULL an, um das aktuelle dvd-Volume oder das Standard-DVD-Volume zu verwenden.
[out] pullDiscID
Empfängt die 64-Bit-Datenträger-ID.
Rückgabewert
Gibt einen der folgenden HRESULT-Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Erfolg. |
|
Ungültiges Argument. |
|
Der DVD-Navigator wird nicht initialisiert. |
|
Der angegebene Pfad ist kein gültiger DVD-Datenträger. |
Bemerkungen
Der DVD Navigator berechnet eine Bezeichner-ID basierend auf Dateigrößen, Datumsangaben und anderen Informationen und nicht auf dem BCA-Wert (Burstschneidbereich). Diese Nummer ist bei jeder Wiedergabe der Disc garantiert gleich. Die ID gilt für alle replizierten Kopien eines Datenträgers. Mit anderen Worten, alle Kopien eines bestimmten Films haben die gleiche ID. Die Wahrscheinlichkeit, dass zwei separate Titel dieselbe ID aufweisen, ist so weit entfernt, dass diese ID für alle praktischen Zwecke als "eindeutig" betrachtet werden kann.
Anforderungen
| 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 |