ACMFILTERDETAILS 구조체(msacm.h)

아티클
03/15/2023

ACMFILTERDETAILS 구조체는 ACM 드라이버의 특정 필터 태그에 대한 파형 오디오 필터를 자세히 설명합니다.

구문

typedef struct tACMFILTERDETAILS {
  DWORD        cbStruct;
  DWORD        dwFilterIndex;
  DWORD        dwFilterTag;
  DWORD        fdwSupport;
  LPWAVEFILTER pwfltr;
  DWORD        cbwfltr;
  char         szFilter[ACMFILTERDETAILS_FILTER_CHARS];
} ACMFILTERDETAILS, *PACMFILTERDETAILS, *LPACMFILTERDETAILS;

멤버

cbStruct

ACMFILTERDETAILS 구조체의 크기(바이트)입니다. acmFilterDetails 또는 acmFilterEnum 함수를 호출하기 전에 이 멤버를 초기화해야 합니다. 이 멤버에 지정된 크기는 기본 ACMFILTERDETAILS 구조를 포함할 수 있을 만큼 커야 합니다. acmFilterDetails 함수가 반환되면 이 멤버는 반환되는 정보의 실제 크기를 포함합니다. 반환된 정보는 요청된 크기를 초과하지 않습니다.

dwFilterIndex

검색할 세부 정보에 대한 필터의 인덱스입니다. 인덱스 범위는 필터 태그에 대해 ACM 드라이버에서 지원하는 표준 필터 수보다 0개에서 1개 미만입니다. 필터 태그에 대해 드라이버에서 지원하는 표준 필터의 수는 ACMFILTERTAGDETAILS 구조에 포함되어 있습니다. dwFilterIndex 멤버는 인덱스별로 드라이버에 대한 표준 필터 세부 정보를 쿼리할 때만 사용됩니다. 그렇지 않으면 이 멤버는 0이어야 합니다. 또한 애플리케이션이 필터에 대한 세부 정보를 쿼리할 때 이 멤버는 ACM에 의해 0으로 설정됩니다. 즉, 이 멤버는 입력에만 사용되며 ACM 또는 ACM 드라이버에서 반환되지 않습니다.

dwFilterTag

ACMFILTERDETAILS 구조에서 설명하는 파형 오디오 필터 태그입니다. 이 멤버는 ACM_FILTERDETAILSF_INDEX 쿼리 플래그에 대한 입력으로 사용됩니다. ACM_FILTERDETAILSF_FORMAT 쿼리 플래그의 경우 pwfltr 멤버가 지정한 것과 동일한 필터 태그로 이 멤버를 초기화해야 합니다. acmFilterDetails 함수가 성공하면 이 멤버는 항상 반환됩니다. 이 멤버는 다른 모든 쿼리 플래그에 대해 WAVE_FILTER_UNKNOWN 설정해야 합니다.

fdwSupport

지정된 필터와 관련된 드라이버 지원 플래그입니다. 이러한 플래그는 ACMDRIVERDETAILS 구조와 동일하지만 쿼리 중인 필터와 관련이 있습니다. 이 멤버는 다음 값의 조합일 수 있으며 드라이버가 필터 태그에 대해 지원하는 작업을 식별합니다.

Name	Description
ACMDRIVERDETAILS_SUPPORTF_ASYNC	드라이버는 비동기 변환을 지원합니다.
ACMDRIVERDETAILS_SUPPORTF_CODEC	드라이버는 지정된 필터를 사용하는 동안 서로 다른 두 형식 태그 간의 변환을 지원합니다. 예를 들어 드라이버가 지정된 필터를 사용하여 WAVE_FORMAT_PCM WAVE_FORMAT_ADPCM 압축을 지원하는 경우 이 플래그가 설정됩니다.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	드라이버는 지정된 필터를 사용하는 동안 동일한 형식 태그의 서로 다른 두 형식 간 변환을 지원합니다. 예를 들어 드라이버가 지정된 필터를 사용하여 WAVE_FORMAT_PCM 다시 샘플링을 지원하는 경우 이 플래그가 설정됩니다.
ACMDRIVERDETAILS_SUPPORTF_FILTER	드라이버는 필터를 지원합니다(형식 특성을 변경하지 않고 데이터 수정). 예를 들어 드라이버가 WAVE_FORMAT_PCM 볼륨 또는 에코 작업을 지원하는 경우 이 플래그가 설정됩니다.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	드라이버는 파형 오디오 디바이스를 통해 지정된 필터를 사용하여 하드웨어 입력, 출력 또는 둘 다를 지원합니다. 애플리케이션은 acmMetrics 함수를 ACM_METRIC_HARDWARE_WAVE_INPUT 및 ACM_METRIC_HARDWARE_WAVE_OUTPUT 메트릭 인덱스와 함께 사용하여 지원 ACM 드라이버와 연결된 파형 오디오 디바이스 식별자를 검색해야 합니다.

pwfltr

필터 세부 정보를 수신할 WAVEFILTER 구조체에 대한 포인터입니다. acmFilterDetails 함수를 사용하여 ACM_FILTERDETAILSF_FILTER 플래그를 지정하지 않는 한 이 구조는 애플리케이션에서 초기화할 필요가 없습니다. 이 경우 WAVEFILTER 구조체의 dwFilterTag 멤버는 ACMFILTERDETAILS 구조체의 dwFilterTag 멤버와 같아야 합니다.

cbwfltr

pwfltr에서 필터 세부 정보를 수신하는 데 사용할 수 있는 크기(바이트)입니다. acmMetrics 및 acmFilterTagDetails 함수를 사용하여 지정된 드라이버(또는 설치된 모든 ACM 드라이버)에 사용할 수 있는 필터에 필요한 최대 크기를 확인할 수 있습니다.

szFilter[ACMFILTERDETAILS_FILTER_CHARS]

dwFilterTag 형식에 대한 필터를 설명하는 문자열입니다. acmFilterDetails 함수가 성공하면 이 문자열은 항상 반환됩니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	msacm.h