IMiniportAudioSignalProcessing::GetModes 메서드(portcls.h)
GetModes 메서드는 오디오 핀에서 지원하는 오디오 신호 처리 모드를 검색합니다.
구문
NTSTATUS GetModes(
[in] ULONG Pin,
[out, optional] GUID *SignalProcessingModes,
[in, out] ULONG *NumSignalProcessingModes
);
매개 변수
[in] Pin
오디오 핀의 인덱스입니다.
[out, optional] SignalProcessingModes
이 매개 변수는 선택적 요소입니다. Pin 매개 변수에서 지원하는 신호 처리 모드를 식별하는 GUID 배열을 반환합니다.
[in, out] NumSignalProcessingModes
입력으로 사용되는 경우 SignalProcessingModes에 지정된 버퍼에 쓸 수 있는 요소 수를 지정합니다. 출력으로 사용하면 버퍼에 기록된 요소의 수를 반환합니다.
반환 값
GetModes는 호출이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 메서드는 적절한 오류 코드를 반환합니다.
설명
SignalProcessingModes가 NULL이면 GetModes는 지원되는 모드 수를 NumSignalProcessingModes에 쓰고 STATUS_SUCCESS 반환합니다. 이를 통해 호출자는 버퍼를 할당하기 위해 지원되는 모드 수를 쿼리할 수 있습니다.
SignalProcessingModes가 NULL이 아닌 경우 GetModes는 NumSignalProcessingModes가 지원되는 모드 수보다 크거나 같은지 확인합니다. 이 경우 메서드는 지원되는 모드를 SignalProcessingModes 버퍼에 쓰고, 지원되는 실제 모드 수를 NumSignalProcessingModes에 쓰고, STATUS_SUCCESS 반환합니다.
다음 표에서는 GetModes에서 반환할 수 있는 것보다 많은 오류 메시지를 제시하고 설명합니다.
| 오류 코드 | Description |
|---|---|
| STATUS_BUFFER_TOO_SMALL | NumSignalProcessingModes에 대해 따로 설정된 버퍼가 너무 작습니다. |
| STATUS_INVALID_PARAMETER | Pin 매개 변수의 값은 필터의 핀 팩터리 수를 >핀 ID를 나타냅니다. 핀 인덱스는 0부터 시작하므로 필터의 n 핀 팩터리에 대해 가장 높은 인덱스 값은 n-1이어야 합니다. |
| STATUS_NOT_SUPPORTED | 신호 처리 모드를 지원하지 않는 핀에 대해 핀 ID가 지정되었습니다. 예를 들어 고정 ID가 오디오 루프백 핀 또는 브리지 핀을 참조하는 경우 GetModes 는 이 오류 코드를 반환합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8.1 |
| 지원되는 최소 서버 | Windows Server 2012 R2 |
| 대상 플랫폼 | 유니버설 |
| 헤더 | portcls.h |