IAMExtTransport::GetTransportBasicParameters 메서드(strmif.h)

아티클
07/28/2023

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 GetTransportBasicParameters 외부 전송의 일반 속성을 검색합니다.

구문

HRESULT GetTransportBasicParameters(
  [in]      long     Param,
  [in, out] long     *pValue,
  [in, out] LPOLESTR *ppszData
);

매개 변수

[in] Param

받을 속성을 지정합니다.

[in, out] pValue

긴 정수 값을 받는 변수에 대한 포인터입니다. 자세한 내용은 설명 부분을 참조하십시오.

[in, out] ppszData

문자열을 수신하는 LPOLESTR 형식의 변수에 대한 포인터입니다. 자세한 내용은 설명 부분을 참조하십시오.

반환 값

이 메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

설명

Param 매개 변수는 검색할 속성을 지정하는 플래그입니다. 일부 속성은 숫자입니다. pValue 매개 변수에 반환됩니다. 다른 속성은 문자열 값입니다. ppszData 매개 변수에 반환됩니다. 플래그 및 예상 값 목록은 IAMExtTransport::SetTransportBasicParameters를 참조하세요.

메서드가 문자열을 반환하는 경우 호출자는 CoTaskMemFree 함수를 사용하여 문자열을 해제해야 합니다.

DV 및 MPEG 캠코더 구현

MSDV 는 다음과 같은 추가 플래그를 지원합니다.

ED_RAW_EXT_DEV_CMD: 원시 AV/C 명령을 호출합니다. AV/C 명령을 ppszData 매개 변수에서 바이트 배열로 지정합니다. pValue 매개 변수에서 명령의 크기(바이트)를 지정합니다. 메서드가 반환되면 ppszData 에는 디바이스의 응답이 포함되고 pValue 에는 응답 크기(바이트)가 포함됩니다. AV/C 명령은 유효성 검사 또는 오류 검사 없이 디바이스에 직접 전달됩니다.
응답 페이로드는 명령보다 클 수 있습니다. 응답에 대한 버퍼에 충분한 공간을 할당하는 것은 호출자의 책임입니다. 최대 페이로드 크기는 512바이트입니다.

자세한 내용은 원시 AV/C 명령 발급을 참조하세요.

ED_TRANSBASIC_INPUT_SIGNAL: DV 캠코더가 수락하도록 설계된 신호 형식을 검색합니다. pValue에서 다음 상수 중 하나를 반환합니다.

상수	Description
ED_TRANSBASIC_SIGNAL_525_60_SD	NTSC SD 신호.
ED_TRANSBASIC_SIGNAL_525_60_SDL	NTSC SDL(롱 플레이) 신호입니다.
ED_TRANSBASIC_SIGNAL_625_50_SD	PAL SD 신호입니다.
ED_TRANSBASIC_SIGNAL_625_50_SDL	PAL SDL(롱 플레이) 신호입니다.
ED_TRANSBASIC_SIGNAL_MPEG2TS	D-VHS 신호.

ED_TRANSBASIC_OUTPUT_SIGNAL: DV 캠코더가 전송하도록 설계된 신호 형식을 검색합니다. ED_TRANSBASIC_INPUT_SIGNAL 플래그에 대해 나열된 상수 중 하나를 반환합니다.

MSTape 는 ED_TRANSBASIC_INPUT_SIGNAL 및 ED_TRANSBASIC_OUTPUT_SIGNAL 대한 추가 값을 지원합니다.

상수	Description
ED_TRANSBASIC_SIGNAL_2500_60_MPEG	25Mbps/60 MPEG 스트림.
ED_TRANSBASIC_SIGNAL_1250_60_MPEG	12.5-Mbps/60 MPEG 스트림.
ED_TRANSBASIC_SIGNAL_0625_60_MPEG	6.25-Mbps/60 MPEG 스트림.
ED_TRANSBASIC_SIGNAL_2500_50_MPEG	25Mbps/50 MPEG 스트림.
ED_TRANSBASIC_SIGNAL_1250_50_MPEG	12.5Mbps/50 MPEG 스트림.
ED_TRANSBASIC_SIGNAL_0625_50_MPEG	6.25-Mbps/50 MPEG 스트림.
ED_TRANSBASIC_SIGNAL_UNKNOWN	알 수 없는 신호 형식입니다.

이러한 플래그는 Xprtdefs.h 헤더 파일에 정의되어 있습니다.

Windows XP 서비스 팩 2 이상에서는 ED_TRANSBASIC_INPUT_SIGNAL 및 ED_TRANSBASIC_OUTPUT_SIGNAL 플래그에 대해 다음과 같은 추가 신호 형식이 정의됩니다.

상수	Description
ED_TRANSBASIC_SIGNAL_525_60_DV25	DVCPRO 25, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV25	DVCPRO 25, 625-50.
ED_TRANSBASIC_SIGNAL_525_60_DV50	DVCPRO 50, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV50	DVCPRO 50, 625-50.
ED_TRANSBASIC_SIGNAL_HD_60_DVH1	DVCPRO 100, 1080i 또는 720p
ED_TRANSBASIC_SIGNAL_HD_50_DVH1	DVCPRO 100, 1080i만

이러한 상수를 사용하려면 Windows SDK Xprtdefs.h 헤더 파일을 포함합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	strmif.h(Dshow.h 포함)
라이브러리	Strmiids.lib

추가 정보

오류 및 성공 코드

IAMExtTransport 인터페이스

다음을 통해 공유