KSPROPERTY_AUDIO_FILTER_STATE
KSPROPERTY_AUDIO_FILTER_STATE 속성은 GFX 필터에서 지원하는 속성 집합 목록을 쿼리하는 데 사용됩니다. 목록은 속성 집합 GUID 배열 형식으로 검색됩니다.
사용 요약 테이블
| 가져오기 | 설정 | 대상 | 속성 설명자 형식 | 속성 값 형식 |
|---|---|---|---|---|
예 |
예 |
필터 |
GUID 배열 |
속성 데이터(작업 데이터)는 GUID 배열입니다. 배열의 각 GUID는 필터가 지원하는 속성 집합을 지정합니다.
반환 값
KSPROPERTY_AUDIO_FILTER_STATE 속성 요청은 성공적으로 완료되었음을 나타내는 STATUS_SUCCESS 반환합니다. 그렇지 않으면 요청이 적절한 오류 상태 코드를 반환합니다.
설명
이 속성이 반환하는 GUID 배열의 크기는 필터에서 지원하는 속성 집합의 수에 따라 달라집니다. 배열을 검색하기 전에 클라이언트는 먼저 미니포트 드라이버의 속성 처리기에 길이가 0인 속성-값 버퍼가 있는 KSPROPERTY_AUDIO_FILTER_STATE get-property 요청을 전송하여 속성의 GUID 배열 크기를 쿼리합니다. 처리기는 필요한 버퍼 크기와 상태 코드 STATUS_BUFFER_OVERFLOW 반환하여 응답합니다. 자세한 내용은 오디오 속성 처리기를 참조하세요.
KSPROPERTY_AUDIO_FILTER_STATE get-property 요청의 GUID 배열을 사용하면 운영 체제가 각 속성 집합 내의 속성을 직렬로 심문할 수 있습니다. 이 정보를 통해 운영 체제는 필터가 인스턴스화될 때 GFX 필터 개체의 상태를 복원하고 필터가 제거될 때 GFX 필터 개체의 상태를 저장할 수 있습니다. GFX 필터의 상태를 저장하거나 복원할 때 운영 체제는 KS 속성에 설명된 대로 각 속성 집합의 속성에 대한 요청을 직렬화합니다. GFX 필터의 상태를 저장하고 복원하는 목적은 사용자가 필터 설정에 대해 변경한 내용을 보존하고 필터의 연속 인스턴스화에서 설정을 영구적으로 유지하는 것입니다. .
요구 사항
헤더 |
Ksmedia.h(Ksmedia.h 포함) |