Freigeben über


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