IDvdInfo2::GetCmdFromEvent-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 GetCmdFromEvent -Methode ruft ein IDvdCmd-Objekt aus einem EC_DVD_CMD_START- oder EC_DVD_CMD_END-Ereignis ab.

Syntax

HRESULT GetCmdFromEvent(
  [in]  LONG_PTR lParam1,
  [out] IDvdCmd  **pCmdObj
);

Parameter

[in] lParam1

Der lParam1-Parameter der Ereignisbenachrichtigung.

[out] pCmdObj

Empfängt einen Zeiger auf die IDvdCmd-Schnittstelle , die dem Befehl zugeordnet ist, der das Ereignis ausgelöst hat.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_FAIL	Der Befehl ist nicht mehr vorhanden.
E_POINTER	Ungültiges Argument.

Hinweise

Diese Methode ordnet den lParam1-Parameter eines EC_DVD_CMD_START- oder EC_DVD_CMD_END-Ereignisses einem IDvdCmd-Objekt zu, das dem Befehl zugeordnet ist, der das Ereignis ausgelöst hat. Sie können dann WaitForStart oder WaitForEnd aufrufen, um das Blockierungsverhalten des DVD-Navigators in Bezug auf diesen Befehl zu steuern. Das IDvdCmd-Objekt wird vom DVD-Navigator erstellt, und für den zurückgegebenen Zeiger wurde die Verweisanzahl bereits erhöht, sodass Sie es nach der Rückgabe von WaitForStart oder WaitForEnd freigeben müssen.

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

IDvdInfo2-Schnittstelle

Synchronisieren von DVD-Befehlen