IAMTimeline::ValidateSourceNames-Methode
[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.]
Hinweis
[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]
Die ValidateSourceNames -Methode überprüft die Quellnamen im Zeitleiste mithilfe des Medienlocators. Optional aktualisiert diese Methode auch jedes Quellobjekt, für das eine Datei gefunden wird.
Syntax
HRESULT ValidateSourceNames(
long ValidateFlags,
IMediaLocator *pOverride,
long NotifyEventHandle
);
Parameter
-
ValidateFlags
-
Bitweise Kombination von Dateinamenüberprüfungsflags , die das Verhalten des Medienlocators angeben. Die flags SFN_VALIDATEF_REPLACE und SFN_VALIDATEF_CHECK müssen vorhanden sein, oder die Methode gibt E_INVALIDARG zurück.
-
pOverride
-
Optionaler Zeiger auf die IMediaLocator-Schnittstelle eines Medienlocators, der anstelle des Standardwerts verwendet werden soll. Um den Standardmedienlocator zu verwenden, legen Sie den Wert dieses Parameters auf NULL fest. Weitere Informationen finden Sie unter Hinweise.
-
NotifyEventHandle
-
Handle für ein Ereignis. Die -Methode signalisiert das Ereignis, nachdem die Überprüfung abgeschlossen wurde.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Bemerkungen
Mithilfe des pOverride-Parameters können Sie Ihre eigene benutzerdefinierte Implementierung der IMediaLocator-Schnittstelle bereitstellen. Beispielsweise benachrichtigt der Standardmedienlocator Ihre Anwendung nicht über die Dateien, die sie findet (oder nicht finden kann). Um diese Einschränkung zu umgehen, können Sie einen benutzerdefinierten Medienlocator implementieren und ihn zu einem Wrapper für die Standardversion machen. Übergeben Sie in Ihrer benutzerdefinierten Version IMediaLocator::FindMediaFile-Aufrufe direkt an die Standardversion, und überprüfen Sie den Rückgabewert.
Hinweis
Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern ab Version 7 kompatibel.
Hinweis
Um Qedit.h zu erhalten, laden Sie das Microsoft Windows SDK Update für Windows Vista und .NET Framework 3.0 herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch