IAMFilterData::CreateFilterData, méthode
[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.]
Notes
Cette interface a été déconseillée. Les nouvelles applications ne doivent pas l’utiliser.
La CreateFilterData méthode crée des données de registre binaires pour un filtre. Ces données peuvent être écrites dans le Registre sous la forme d’une sous-clé REG_BINARY nommée FilterData, sous la clé CLSID du filtre.
Il n’y a généralement aucune raison pour une application d’appeler cette méthode. La méthode IFilterMapper2::RegisterFilter crée automatiquement les données binaires et les ajoute à l’emplacement approprié dans le Registre. Pour plus d’informations, consultez Comment inscrire des filtres DirectShow.
Syntaxe
HRESULT CreateFilterData(
[in] REGFILTER2 *prf2,
[out] BYTE **prgbFilterData,
[out] ULONG *pcb
);
Paramètres
-
prf2 [in]
-
Pointeur vers une structure REGFILTER2 qui contient les informations de filtre.
-
prgbFilterData [out]
-
Adresse d’une variable qui reçoit un pointeur vers les données binaires. La méthode alloue la mémoire pour les données. L’appelant doit libérer la mémoire en appelant la méthode CoTaskMemFree .
-
pcb [out]
-
Pointeur vers une variable qui reçoit la taille des données binaires, en octets.
Valeur renvoyée
Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.
Notes
Notes
L’en-tête Fil_data.h se trouve dans le répertoire Exemple de Mappeur dans le KIT de développement logiciel (SDK) Windows.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| DLL |
|
Voir aussi