Partager via


Méthode CMediaEvent.GetIDsOfNames

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Mappe une fonction membre unique et un ensemble de paramètres facultatifs à un ensemble correspondant d’identificateurs de répartition d’entiers, qui peuvent être utilisés lors des appels ultérieurs à la fonction membre CMediaEvent::Invoke .

Syntaxe

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

Paramètres

riid

Identificateur de référence. Réservé pour un usage futur. Doit avoir la valeur NULL.

rgszNames

Adresse d’un pointeur vers un tableau de noms transmis à mapper.

cNames

Compte des noms à mapper.

lcid

Contexte de paramètres régionaux dans lequel interpréter les noms.

rgdispid

Pointeur vers un tableau alloué par l’appelant, dont chaque élément contient un ID correspondant à l’un des noms passés dans le tableau rgszNames . Le premier élément représente le nom du membre ; les éléments suivants représentent chacun des paramètres du membre.

Valeur renvoyée

Retourne l’une des valeurs suivantes.

Code de retour Description
DISP_E_UNKNOWN_CLSID
Le CLSID n’a pas été reconnu.
DISP_E_UNKNOWNNAME
Un ou plusieurs des noms n’étaient pas connus. Les DISPID retournés contiennent DISPID_UNKNOWN pour chaque entrée correspondant à un nom inconnu.
E_OUTOFMEMORY
Mémoire insuffisante.
S_OK
Opération réussie.

Configuration requise

Condition requise Valeur
En-tête
Ctlutil.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

Classe CMediaEvent