KSPROPERTY_RTAUDIO_SETWRITEPACKET

  • Artículo

KSPROPERTY_RTAUDIO_SETWRITEPACKET informa al controlador de que el sistema operativo ha escrito datos válidos en el búfer de WaveRT.

Tabla de resumen de uso

Obtener Set Destino Tipo de descriptor de propiedad Tipo de valor de propiedad
No Sí Anclar KSPROPERTY KSRTAUDIO_SETWRITEPACKET_INFO

El descriptor de propiedad (datos de instancia) es una estructura KSPROPERTY . Antes de enviar la solicitud, el cliente carga la estructura con valores que incluyen el número de paquete, la longitud del paquete y otra información.

El valor de propiedad es una estructura de tipo KSRTAUDIO_SETWRITEPACKET_INFO.

Valor devuelto

Una solicitud de propiedad KSPROPERTY_RTAUDIO_SETWRITEPACKET devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado.

Observaciones

Si se admite este KSPROPERTY, el controlador puede usar opcionalmente la información proporcionada para optimizar la transferencia de hardware. Por ejemplo, el controlador podría optimizar las transferencias DMA o programar hardware para detener la transferencia al final del paquete especificado en caso de que el sistema operativo no llame a esta rutina de nuevo para informar al controlador de otro paquete. Esto puede mitigar los efectos audibles del subflujo, por ejemplo, introducir una brecha audible en lugar de repetir un búfer circular. Sin embargo, el conductor sigue obligado a aumentar su contador interno de paquetes y eventos de notificación de señal a una velocidad nominal en tiempo real.

Excepto cuando el sistema operativo especifica la marca de KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM , el tamaño del paquete es el tamaño del búfer de WaveRT dividido por notificationCount pasado a KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.

Dependiendo de las funcionalidades de hardware, si se especifica la marca KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM , el controlador puede silenciar una parte del búfer waveRT que sigue al paquete EOS en caso de que el hardware transfiera datos más allá de la posición EOS.

Requisitos

Versión

Disponible en Windows 10 y sistemas operativos Windows posteriores.

Encabezado

 Ksmedia.h

Vea también

KSPROPERTY_RTAUDIO_GETREADPACKET

UsePositionLock