KSPROPERTY_PIN_PROPOSEDATAFORMAT

Artículo
06/15/2023

Los clientes usan la propiedad KSPROPERTY_PIN_PROPOSEDATAFORMAT para determinar si los pines creados por el generador de patillas admiten un formato de datos específico.

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
Sí	Sí	Filtrar	KSP_PIN	KSDATAFORMAT

Observaciones

KSPROPERTY_PIN_PROPOSEDATAFORMAT incluye una estructura de tipo KSDATAFORMAT, especificando el formato de datos propuesto. Especifique esta propiedad mediante KSP_PIN, donde el miembro especifica el generador de patillas correspondiente.

El uso de KSPROPERTY_TYPE_GET con esta propiedad permite al controlador de audio proporcionar información sobre el formato de datos predeterminado en un pin. KSPROPERTY_TYPE_GET es opcional implementar para esta propiedad a menos que el controlador admita KSEVENT_PINCAPS_FORMATCHANGE.

El filtro KS devuelve STATUS_SUCCESS cuando se usa esta propiedad con KSPROPERTY_TYPE_SET si se pueden establecer patillas en o abrirse con el formato de datos propuesto. Si el pin no se puede establecer en el formato de datos propuesto, devuelve STATUS_NO_MATCH. Para cualquier otro error, se devuelve un error adecuado. Si el controlador admite KSPROPERTY_AUDIOSIGNALPROCESSING_MODES, esta propiedad debe devolver STATUS_SUCCESS si alguno de los modos de procesamiento de señal de audio admite el formato.

El uso de KSPROPERTY_TYPE_SET con esta propiedad no cambia realmente el formato de datos. Los clientes usan KSPROPERTY_CONNECTION_DATAFORMAT para cambiar el formato de datos. KSPROPERTY_TYPE_SET es opcional implementar para esta propiedad.