IAMExtTransport ::SetEditPropertySet, méthode (strmif.h)

Article
03/04/2024

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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.]

La SetEditPropertySet méthode inscrit un jeu de propriétés d’édition qui décrit un groupe de propriétés d’édition.

Cette méthode n’est pas implémentée.

Syntaxe

HRESULT SetEditPropertySet(
  [in, out] long *pEditID,
  [in]      long State
);

Paramètres

[in, out] pEditID

Pointeur vers un entier long qui spécifie ou reçoit un identificateur pour le jeu de propriétés d’édition.

[in] State

Spécifie l’état du jeu de propriétés d’édition.

Valeur	Description
ED_ACTIVE	Active le jeu de propriétés d’édition.
ED_DELETE	Supprime le jeu de propriétés d’édition.
ED_INACTIVE	Active l’ensemble de propriétés de modification.
ED_REGISTER	Inscrit le jeu de propriétés d’édition.

Si la valeur est ED_REGISTER, le paramètre pEditID reçoit un identificateur pour le jeu de propriétés d’édition. Pour les autres indicateurs, utilisez le paramètre pEditID pour spécifier l’identificateur.

Valeur retournée

Lorsque cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .

Remarques

Un événement de modification est un ensemble de paramètres qui définissent une séquence d’enregistrement. Par exemple, les paramètres peuvent spécifier des modes d’édition, des inpoints et des points d’extérieur, ou rechercher des positions. Chaque événement de modification se compose d’un ou plusieurs paramètres, appelés propriétés d’édition. La collection de propriétés est appelée jeu de propriétés d’édition. Chaque jeu de propriétés d’édition est identifié par un entier long , attribué par le filtre d’appareil.

Pour créer et exécuter un événement de modification, l’application doit effectuer les opérations suivantes :

Inscrire un jeu de propriétés d’édition. Appelez la SetEditPropertySet méthode avec la valeur ED_REGISTER dans le paramètre State . Lorsque la méthode est retournée, le paramètre pEditID contient l’identificateur du jeu de propriétés edit. Utilisez ce numéro pour identifier la propriété d’édition définie dans les appels de méthode suivants.
Spécifiez les propriétés de modification à l’aide de la méthode IAMExtTransport ::SetEditProperty .
Activez l’événement de modification en appelant SetEditPropertySet avec la valeur ED_ACTIVE.
Indiquez le transport en appelant SetEditProperty avec la valeur ED_EDIT_SEEK.
Exécutez le graphique de filtre.

Par exemple, le code suivant configure une modification d’insertion sur toutes les pistes :

C++
Inscrivez un ID de jeu de propriétés de modification. (Provoque l’allocation de mémoire.) long EditId ; SetEditPropertySet(&EditId, ED_REGISTER) ; Définissez le mode d’édition. SetEditProperty(EditId, ED_EDIT_MODE, ED_EDIT_MODE_INSERT) ; Définissez les détails de l’événement. SetEditProperty(EditId, ED_EDIT_TRACK, ED_VIDEO \| ED_AUDIO_ALL) ; SetEditProperty(EditId, ED_REHEARSE_MODE, ED_EDIT_PERFORM) ; Définissez les heures de source et d’enregistrement. SetEditProperty(EditId, ED_EDIT_SRC_INPOINT, 200) SetEditProperty(EditId, ED_EDIT_SRC_OUTPOINT, 500) SetEditProperty(EditId, ED_EDIT_REC_INPOINT, 100) SetEditProperty(EditId, ED_EDIT_REC_OUTPOINT, 400) Activez l’événement de modification. SetEditPropertySet(&EditId, ED_ACTIVE) ; Indiquez la machine. SetEditProperty(EditId, ED_EDIT_SEEK, OATRUE) ; // Run the graph. (Not shown.)

C++

Inscrivez un ID de jeu de propriétés de modification. (Provoque l’allocation de mémoire.) long EditId ; SetEditPropertySet(&EditId, ED_REGISTER) ;Définissez le mode d’édition.
SetEditProperty(EditId, ED_EDIT_MODE, ED_EDIT_MODE_INSERT) ; Définissez les détails de l’événement.
SetEditProperty(EditId, ED_EDIT_TRACK, ED_VIDEO | ED_AUDIO_ALL) ; SetEditProperty(EditId, ED_REHEARSE_MODE, ED_EDIT_PERFORM) ;
Définissez les heures de source et d’enregistrement.
SetEditProperty(EditId, ED_EDIT_SRC_INPOINT, 200) SetEditProperty(EditId, ED_EDIT_SRC_OUTPOINT, 500) SetEditProperty(EditId, ED_EDIT_REC_INPOINT, 100) SetEditProperty(EditId, ED_EDIT_REC_OUTPOINT, 400)
Activez l’événement de modification.
SetEditPropertySet(&EditId, ED_ACTIVE) ; Indiquez la machine.
SetEditProperty(EditId, ED_EDIT_SEEK, OATRUE) ;
// Run the graph. (Not shown.)

Implémentation de DV

MSDV ne prend pas en charge cette méthode. Elle retourne E_NOTIMPL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IAMExtTransport, interface

IAMExtTransport ::GetEditPropertySet

Partager via