ACMFORMATDETAILS 구조체(msacm.h)

아티클
02/29/2024

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

구문

typedef struct tACMFORMATDETAILS {
  DWORD          cbStruct;
  DWORD          dwFormatIndex;
  DWORD          dwFormatTag;
  DWORD          fdwSupport;
  LPWAVEFORMATEX pwfx;
  DWORD          cbwfx;
  char           szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
} ACMFORMATDETAILS, *PACMFORMATDETAILS, *LPACMFORMATDETAILS;

멤버

cbStruct

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

dwFormatIndex

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

dwFormatTag

ACMFORMATDETAILS 구조체에서 설명하는 파형 오디오 형식 태그입니다. 이 멤버는 ACM_FORMATDETAILSF_INDEX 쿼리 플래그에 대한 입력에 사용됩니다. ACM_FORMATDETAILSF_FORMAT 쿼리 플래그의 경우 pwfx 멤버가 지정한 것과 동일한 형식 태그로 이 멤버를 초기화해야 합니다. acmFormatDetails 함수에 대한 호출이 성공하면 이 멤버가 항상 반환됩니다. 이 멤버는 다른 모든 쿼리 플래그에 대해 WAVE_FORMAT_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	드라이버는 파형 오디오 디바이스를 통해 지정된 형식의 하드웨어 입력 및/또는 출력을 지원합니다. 애플리케이션은 ACM_METRIC_HARDWARE_WAVE_INPUT 및 ACM_METRIC_HARDWARE_WAVE_OUTPUT 메트릭 인덱 스와 함께 acmMetrics 를 사용하여 지원 ACM 드라이버와 연결된 파형 오디오 디바이스 식별자를 가져와야 합니다.

pwfx

형식 세부 정보를 받을 WAVEFORMATEX 구조체에 대한 포인터입니다. acmFormatDetails 함수에 ACM_FORMATDETAILSF_FORMAT 플래그를 지정하지 않는 한 이 구조는 애플리케이션에서 초기화할 필요가 없습니다. 이 경우 WAVEFORMATEX 구조체의 wFormatTag 멤버는 ACMFORMATDETAILS 구조체의 dwFormatTag와 같아야 합니다.

cbwfx

pwfx가 형식 세부 정보를 수신하는 데 사용할 수 있는 크기(바이트)입니다. acmMetrics 및 acmFormatTagDetails 함수를 사용하여 지정된 드라이버(또는 설치된 모든 ACM 드라이버)에 사용할 수 있는 모든 형식에 필요한 최대 크기를 결정할 수 있습니다.

szFormat[ACMFORMATDETAILS_FORMAT_CHARS]

dwFormatTag 형식의 형식을 설명하는 문자열입니다. acmFormatDetails 함수가 성공하면 이 문자열이 항상 반환됩니다.

요구 사항

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