Método IAMDevMemoryControl::WriteSync (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Nota La interfaz IAMDevMemoryControl está en desuso.

 

Se usa para sincronizar con la escritura completada. Este método devuelve cuando los datos que se escriben en la región de asignador determinada se escriben completamente en la memoria.

Sintaxis

HRESULT WriteSync();

Valor devuelto

Devuelve un valor HRESULT . Entre los valores posibles figuran los siguientes:

Código devuelto	Descripción
E_FAIL	Se ha agotado el tiempo de espera sin que este método confirme que se escribieron los datos.
S_OK	Los datos se escribieron correctamente en la memoria.
VFW_E_NOT_COMMITTED	El asignador no ha llamado al método IMemAllocator::Commit .

Comentarios

Este método garantiza que todas las operaciones de escritura anteriores a la memoria asignada se hayan realizado correctamente. Las operaciones de escritura de memoria posteriores requieren otra llamada a WriteSync.

Este método depende de la implementación y se usa (cuando es necesario) para sincronizar las operaciones de escritura de memoria con la memoria. El controlador de la memoria incorporada proporciona la implementación.

La interfaz IAMDevMemoryControl se encuentra normalmente en la memoria a la que se accede a través de un puente de interconexión de componentes periféricos (PCI). (Un PCI es un bus local para equipos personales que proporciona una ruta de acceso de datos de alta velocidad entre el procesador y los dispositivos periféricos). La memoria detrás de un puente PCI debe sincronizarse después de que se complete una operación de escritura de memoria, si otro dispositivo accederá a esa memoria desde detrás del puente PCI. Esto se debe a que el acceso del host a la memoria se almacena en búfer a través del puente PCI FIFO (primero en salir primero) y el host asume que la escritura se completa antes de que el puente escriba realmente los datos. Una acción posterior realizada por un dispositivo detrás del puente, como un controlador SCSI, podría leer la memoria antes de que se complete la escritura, si no se llama al método IAMDevMemoryControl::WriteSync .

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)

Consulte también

Códigos de error y éxito

IAMDevMemoryControl (interfaz)