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

추가 정보

IMiniportAudioSignalProcessing