IRenderEngine::SetSourceNameValidation-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 SetSourceNameValidation -Methode gibt an, wie die Render-Engine Dateinamen überprüft.
Syntax
HRESULT SetSourceNameValidation(
BSTR FilterString,
IMediaLocator *pOverride,
LONG Flags
);
Parameter
-
FilterString
-
BSTR-Wert , der Paare von Filterzeichenfolgen enthält, formatiert, wie vom lpstrFilter-Member der OPENFILENAME-Struktur erforderlich. Der Medienlocator verwendet diesen Filter, wenn dem Endbenutzer ein Dialogfeld Datei öffnen angezeigt wird.
-
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.
-
Flags
-
Bitweise Kombination von Dateinamenüberprüfungsflags , die das Verhalten des Medienlocators angeben. Das flag SFN_VALIDATEF_CHECK muss vorhanden sein. Das SFN_VALIDATEF_hlinkMUTED-Flag hat bei dieser Methode keine Auswirkungen.
Rückgabewert
Gibt einen der folgenden HRESULT-Werte zurück:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Fehler beim Initialisieren des Rendermoduls. |
Bemerkungen
Mithilfe des pOverride-Parameters können Sie Ihre eigene benutzerdefinierte Implementierung der IMediaLocator-Schnittstelle bereitstellen. Beispielsweise benachrichtigt der Standardmedienlocator eine 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 dann IMediaLocator::FindMediaFile-Aufrufe direkt an die Standardversion, und überprüfen Sie den Rückgabewert.
Derzeit überprüft diese Methode keine dynamisch geladenen Quellen. Siehe IRenderEngine::SetDynamicReconnectLevel.
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