IDvdControl2::SetGPRM-Methode (strmif.h)

Artikel
03/04/2024

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

Die SetGPRM -Methode legt einen allgemeinen Parameterregisterwert fest.

Syntax

HRESULT SetGPRM(
  [in]  ULONG   ulIndex,
  [in]  WORD    wValue,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parameter

[in] ulIndex

Index registrieren; kann ein Wert zwischen 0 und 15 sein.

[in] wValue

Ein 16-Bit-Wert, der im angegebenen Register enthalten ist.

[in] dwFlags

Bitweises OR eines oder mehrerer Flags aus der DVD_CMD_FLAGS-Enumeration , die angibt, wie der Befehl synchronisiert werden soll.

[out] ppCmd

Empfängt einen Zeiger auf ein IDvdCmd-Objekt , das zum Synchronisieren von DVD-Befehlen verwendet werden kann. Der Aufrufer muss die Schnittstelle freigeben. Dieser Parameter kann NULL sein. Weitere Informationen finden Sie unter Synchronisieren von DVD-Befehlen.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Der ulIndex-Parameter ist größer als 15, oder andere Eingabeparameter sind ungültig.

Hinweise

Ein DVD-Datenträger verwendet allgemeine Parameterregister, um verschiedene Arten von Informationen zu speichern. Durch manuelles Festlegen eines oder mehrerer dieser Register kann eine Anwendung möglicherweise bestimmte benutzerdefinierte Funktionen bereitstellen. Dies ist ein erweiterter Befehl, der nur verwendet werden sollte, wenn Sie über umfassende Kenntnisse der DVD-Spezifikation verfügen.

Die folgende Tabelle enthält den Namen des Anhangs J-Befehls, dem dieser Methodenname entspricht, und die Domänen, in denen diese Methode gültig ist.

Anhang J Befehlsname	Gültige Domänen
Keine	Alle

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

IDvdControl2-Schnittstelle

IDvdInfo2::GetAllGPRMs

Share via