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 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.]
Syntaxe
HRESULT WriteSync();
Valeur de retour
Retourne une valeur HRESULT . Il peut prendre les valeurs suivantes :
| Code de retour | Description |
|---|---|
|
Un délai d’attente s’est produit sans que cette méthode confirme que les données ont été écrites. |
|
Les données ont été correctement écrites en mémoire. |
|
L’allocateur n’a pas appelé la méthode IMemAllocator ::Commit . |
Remarques
Cette méthode garantit que toutes les opérations d’écriture précédentes dans la mémoire allouée ont réussi. Les opérations d’écriture de mémoire suivantes nécessitent un autre appel à WriteSync.
Cette méthode dépend de l’implémentation et est utilisée (si nécessaire) pour synchroniser les opérations d’écriture mémoire avec la mémoire. Le pilote de la mémoire embarquée fournit l’implémentation.
L’interface IAMDevMemoryControl se trouve généralement sur la mémoire accessible via un pont PCI (Peripheral Component Interconnect). (Un pci est un bus local pour les ordinateurs personnels qui fournit un chemin de données à haute vitesse entre le processeur et les périphériques.) La mémoire derrière un pont PCI doit être synchronisée une fois l’opération d’écriture de mémoire terminée, si un autre appareil accède à cette mémoire à partir de derrière le pont PCI. En effet, l’accès de l’hôte à la mémoire est mis en mémoire tampon via le pont PCI FIFO (premier entré en premier sorti), et l’hôte suppose que l’écriture est terminée avant que le pont écrive réellement les données. Une action ultérieure d’un appareil derrière le pont, comme un contrôleur SCSI, peut lire la mémoire avant la fin de l’écriture, si la méthode IAMDevMemoryControl ::WriteSync n’est pas appelée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | strmif.h (include Dshow.h) |