KSPROPERTY_PIN_PROPOSEDATAFORMAT

아티클
06/15/2023

클라이언트는 KSPROPERTY_PIN_PROPOSEDATAFORMAT 속성을 사용하여 핀 팩터리에서 인스턴스화된 핀이 특정 데이터 형식을 지원하는지 확인합니다.

사용량 요약 테이블

가져오기	설정	대상	속성 설명자 형식	속성 값 형식
예	예	필터	KSP_PIN	KSDATAFORMAT

설명

KSPROPERTY_PIN_PROPOSEDATAFORMAT 제안된 데이터 형식을 지정하는 KSDATAFORMAT 형식의 구조를 포함합니다. 멤버가 관련 핀 팩터리를 지정하는 KSP_PIN 사용하여 이 속성을 지정합니다.

이 속성에 KSPROPERTY_TYPE_GET 사용하면 오디오 드라이버가 핀의 기본 데이터 형식에 대한 정보를 제공할 수 있습니다. KSPROPERTY_TYPE_GET 드라이버가 KSEVENT_PINCAPS_FORMATCHANGE 지원하지 않는 한 이 속성에 대해 구현하는 데 선택 사항입니다.

KS 필터는 제안된 데이터 형식으로 핀을 설정하거나 열 수 있는 경우 KSPROPERTY_TYPE_SET 이 속성을 사용할 때 STATUS_SUCCESS 반환합니다. 핀을 제안된 데이터 형식으로 설정할 수 없는 경우 STATUS_NO_MATCH 반환합니다. 다른 오류의 경우 적절한 오류가 반환됩니다. 드라이버가 KSPROPERTY_AUDIOSIGNALPROCESSING_MODES 지원하는 경우 이 속성은 오디오 신호 처리 모드에서 형식이 지원되는 경우 STATUS_SUCCESS 반환해야 합니다.

이 속성과 함께 KSPROPERTY_TYPE_SET 사용하면 실제로 데이터 형식이 변경되지 않습니다. 클라이언트는 KSPROPERTY_CONNECTION_DATAFORMAT 사용하여 데이터 형식을 변경합니다. KSPROPERTY_TYPE_SET 이 속성에 대해 구현하는 데 선택 사항입니다.