Condividi tramite


Metodo CMediaControl.GetIDsOfNames

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Esegue il mapping di una singola funzione membro e di un set facoltativo di parametri a un set corrispondente di identificatori di invio integer (DISPID), che possono essere usati nelle chiamate successive alla funzione membro CMediaControl::Invoke .

Sintassi

HRESULT GetIDsOfNames(
   REFIID  riid,
   OLECHAR **rgszNames,
   UINT    cNames,
   LCID    lcid,
   DISPID  *rgdispid
);

Parametri

riid

Identificatore di riferimento. Riservato per utilizzi futuri. Deve essere NULL.

rgszNames

Indirizzo di un puntatore a una matrice passata di nomi da eseguire il mapping.

cNames

Conteggio dei nomi di cui eseguire il mapping.

lcid

Contesto delle impostazioni locali in cui interpretare i nomi.

rgdispid

Puntatore a una matrice allocata dal chiamante, ogni elemento di cui contiene un ID corrispondente a uno dei nomi passati nella matrice rgszNames . Il primo elemento rappresenta il nome del membro; gli elementi successivi rappresentano ognuno dei parametri del membro.

Valore restituito

Restituisce uno dei valori seguenti.

Codice restituito Descrizione
DISP_E_UNKNOWN_CLSID
ClSID non è stato riconosciuto.
DISP_E_UNKNOWNNAME
Uno o più nomi non erano noti. I DISPID restituiti contengono DISPID_UNKNOWN per ogni voce che corrisponde al nome sconosciuto.
E_OUTOFMEMORY
Memoria insufficiente.
S_OK
Operazione completata.

Requisiti

Requisito Valore
Intestazione
Ctlutil.h (includere Streams.h)
Libreria
Strmbase.lib (build al dettaglio);
Strmbasd.lib (build di debug)

Vedi anche

Classe CMediaControl