Metodo IDeviceInfo2::GetCmdFromEvent (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetCmdFromEvent metodo recupera un oggetto I DistribuitCmd da un evento EC_DVD_CMD_START o EC_DVD_CMD_END .

Sintassi

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

Parametri

[in] lParam1

Parametro lParam1 della notifica degli eventi.

[out] pCmdObj

Riceve un puntatore all'interfaccia I DistribuitCmd associata al comando che ha generato l'evento.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_FAIL	Il comando non esiste più.
E_POINTER	Argomento non valido.

Commenti

Questo metodo esegue il mapping del parametro lParam1 di un evento EC_DVD_CMD_START o EC_DVD_CMD_END in un oggetto IItemCmd associato al comando che ha generato l'evento. È quindi possibile chiamare WaitForStart o WaitForEnd per controllare il comportamento di blocco dello strumento di navigazione DVD rispetto a tale comando. L'oggetto I DistribuitCmd viene creato dallo strumento di navigazione DVD e il puntatore restituito ha già avuto il numero di riferimenti incrementato, quindi è necessario rilasciarlo dopo la restituzione di WaitForStart o WaitForEnd .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Applicazioni DVD

Codici di errore e di esito positivo

Interfaccia IInfo2

Sincronizzazione dei comandi DVD