Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La méthode RegisterForEvent inscrit l’application pour recevoir les événements du codec.
Syntaxe
HRESULT RegisterForEvent(
[in] const GUID *Api,
[out] LONG_PTR userData
);
Paramètres
[in] Api
Pointeur vers un GUID qui spécifie l’événement. Il existe trois catégories d’événements :
| Valeur | Signification |
|---|---|
|
Le codec avertit l’application lorsque les propriétés du codec changent. Les données d’événement sont une liste de GUID pour les propriétés qui ont été modifiées. |
|
Le codec avertit l’application lorsque la propriété spécifiée change. En règle générale, un codec prend en charge ce type de notification pour un ensemble limité de propriétés, le cas échéant. |
|
Dépendant de l'implémentation. |
[out] userData
Pointeur vers les données définies par l’appelant. L’application reçoit ce pointeur dans le paramètre d’événement lParam1 .
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
S_OK |
|
Non implémenté. Le codec ne prend pas en charge la notification d’événement ou ne prend pas en charge le GUID d’événement spécifié dans le paramètre Api . |
Remarques
L’application reçoit une notification d’événement EC_CODECAPI_EVENT chaque fois que le codec de l’encodeur envoie l’événement. Pour obtenir l’événement, utilise l’interface IMediaEventEx .
Le paramètre lParam2 de l’événement est un pointeur vers une structure CodecAPIEventData . Cette structure peut être suivie de données supplémentaires, en fonction du GUID d’événement. La taille de ces données est donnée par le membre dataLength .
| GUID | Données d'événements |
|---|---|
| CODECAPI_CHANGELISTS | Tableau de GUID. Chaque GUID spécifie une propriété de codec dont la valeur actuelle ou la plage valide a changé. La taille du tableau est dataLength / sizeof(GUID). |
| GUID de propriété défini dans codecapi.h. | Aucun. |
| GUID d’événement propriétaire. | Dépendant de l'implémentation. |
Si le codec ne prend pas en charge l’événement spécifié, la méthode retourne E_NOTIMPL. Le codec peut prendre en charge d’autres événements.
Pour désactiver les notifications pour un événement, appelez ICodecAPI ::UnregisterForEvent.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 Build 20348 |
| Serveur minimal pris en charge | Windows 10 Build 20348 |
| En-tête | icodecapi.h |