IAMExtDevice::GetCapability 메서드(strmif.h)

  • 아티클

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

메서드는 GetCapability 외부 디바이스의 기능을 검색합니다.

구문

HRESULT GetCapability(
  [in]  long   Capability,
  [out] long   *pValue,
  [out] double *pdblValue
);

매개 변수

[in] Capability

검사 기능을 지정합니다. 자세한 내용은 설명 부분을 참조하십시오.

[out] pValue

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

[out] pdblValue

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

반환 값

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

설명

Capability 매개 변수는 검사 기능을 지정하는 플래그입니다. 메서드는 기능 플래그에 따라 pValue 매개 변수 또는 pdblValue 매개 변수에서 결과를 반환합니다.

다음 플래그의 경우 메서드는 pValue 매개 변수에서 OATRUE 또는 OAFALSE 값을 반환합니다. 값 OATRUE는 기능이 있음을 나타내고 OAFALSE 값은 기능이 없음을 나타냅니다.

기능 플래그 Description
ED_DEVCAP_AUDIO_INPUTS 디바이스는 오디오 입력을 허용합니다.
ED_DEVCAP_CAN_MONITOR_SOURCES 디바이스는 현재 선택된 입력에 관계없이 모니터링되는 출력에 입력을 보낼 수 있습니다.
ED_DEVCAP_CAN_PREVIEW 디바이스를 미리 볼 수 있습니다.
ED_DEVCAP_CAN_RECORD 디바이스는 기록할 수 있습니다.
ED_DEVCAP_CAN_RECORD_STROBE 디바이스는 레코드를 스트로브할 수 있습니다. 이 기능은 선택한 트랙에 기록할 수 있는 멀티트랙 디바이스에 적용됩니다.
ED_DEVCAP_CAN_SAVE 디바이스는 데이터를 저장할 수 있습니다.
ED_DEVCAP_CTLTRK_READ 디바이스는 제어 트랙을 읽을 수 있습니다.
ED_DEVCAP_HAS_AUDIO 디바이스에 오디오가 있습니다.
ED_DEVCAP_HAS_VIDEO 디바이스에 비디오가 있습니다.
ED_DEVCAP_INDEX_READ 디바이스는 인덱스 표시를 읽을 수 있습니다.
ED_DEVCAP_NEEDS_CALIBRATING 디바이스에는 보정이 필요합니다. IAMExtDevice::Calibrate를 참조하세요.
ED_DEVCAP_TIMECODE_READ 디바이스는 SMPTE 시간 코드를 읽을 수 있습니다.
ED_DEVCAP_TIMECODE_WRITE 디바이스는 SMPTE 시간 코드를 설정할 수 있습니다.
ED_DEVCAP_USES_FILES 디바이스에는 기본 제공 파일 시스템이 있습니다.
ED_DEVCAP_VIDEO_INPUTS 디바이스는 비디오 입력을 허용합니다.
 

다음 플래그의 경우 메서드는 pValue 매개 변수에 정의된 상수를 반환합니다.

ED_DEVCAP_DEVICE_TYPE: 디바이스 유형을 반환합니다.

반환된 상수 Description
ED_DEVTYPE_ATR 오디오 테이프 레코더
ED_DEVTYPE_CG 문자 생성기
ED_DEVTYPE_DDR 디지털 디스크 레코더
ED_DEVTYPE_DVE 디지털 비디오 효과 단위
ED_DEVTYPE_GPI 범용 인터페이스 트리거
ED_DEVTYPE_KEYER 비디오 키어
ED_DEVTYPE_LASERDISK Laserdisc
ED_DEVTYPE_MIXER_AUDIO 오디오 믹서
ED_DEVTYPE_MIXER_VIDEO 비디오 믹서
ED_DEVTYPE_ROUTER 비디오 라우터
ED_DEVTYPE_TBC 시간 기반 보정기
ED_DEVTYPE_TCG 시간 코드 생성기/판독기
ED_DEVTYPE_VCR VCR 또는 전체 VCR 기능이 있는 캠코더
ED_DEVTYPE_WIPEGEN 비디오 초기화 생성기
ED_DEVTYPE_JOYSTICK 조이스틱
ED_DEVTYPE_KEYBOARD Keyboard
 

ED_DEVCAP_SYNC_ACCURACY: 디바이스의 동기화 정확도 표시를 반환합니다.

반환된 상수 Description
ED_SYNCACC_PRECISE 디바이스의 정확도가 정확합니다.
ED_SYNCACC_FRAME 디바이스가 프레임 정확합니다.
ED_SYNCACC_ROUGH 디바이스가 프레임 정확도보다 작습니다.
 

ED_DEVCAP_NORMAL_RATE: 디바이스의 일반 프레임 속도를 반환합니다.

반환된 상수 Description
ED_RATE_24 초당 24프레임(fps)
ED_RATE_25 25fps
ED_RATE_2997 29.97fps
ED_RATE_30 30fps
 

ED_DEVCAP_SEEK_TYPE: 디바이스의 검색 정확도 표시를 반환합니다.

반환된 상수 Description
ED_SEEK_PERFECT 디바이스는 신호 중단 없이 하나의 비디오 프레임 내에서 검색할 수 있습니다.
ED_SEEK_FAST 디바이스는 신호의 짧은 중단으로 신속하게 검색할 수 있습니다.
ED_SEEK_SLOW 디바이스가 느리게 검색됩니다. 테이프 전송과 같은
 

다음 플래그의 경우 메서드는 pValue 매개 변수의 숫자 값을 반환합니다.

기능 플래그 반환 값
ED_DEVCAP_EXTERNAL_DEVICE_ID 제조업체별 식별자입니다.
ED_DEVCAP_PREROLL 디바이스 사전 등록 시간.
ED_DEVCAP_POSTROLL 디바이스 사후 등록 시간입니다.
 

Windows XP 서비스 팩 2 이상에서는 ED_DEVCAP_DEVICE_TYPE 다음과 같은 추가 플래그가 지원됩니다.

반환된 상수 Description
ED_DEVTYPE_CAMERA_STORAGE 스틸 이미지 또는 짧은 비디오 파일을 위한 스토리지입니다.
ED_DEVTYPE_DTV 직렬 버스 인터페이스가 있는 디지털 TV.
ED_DEVTYPE_PC_VIRTUAL 컴퓨터의 가상 또는 에뮬레이트된 디바이스입니다.
 

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

DV 구현

MSDV 및 UVC 드라이버는 다음 동작을 지원합니다.

ED_DEVCAP_NORMAL_RATE 플래그는 프레임 속도를 반환합니다.

반환된 상수 Description
ED_RATE_25 25fps(기본 PAL 프레임 속도)
ED_RATE_2997 29.997fps(기본 NTSC 프레임 속도)
 

MSDV의 경우에만 ED_DEVCAP_DEVICE_TYPE 플래그는 디바이스 유형을 반환합니다. 가능한 값은 다음 표에 나와 있습니다. UVC 디바이스의 경우 IKsTopologyInfo 인터페이스를 대신 사용합니다.

반환된 상수 Description
ED_DEVTYPE_CAMERA 녹화하거나 일시 중지할 수 있지만 전체 VCR 기능이 없는 간단한 카메라입니다.
ED_DEVTYPE_DVHS 디바이스는 D-VHS 형식을 지원합니다.
ED_DEVTYPE_UNKNOWN 알 수 없는 디바이스 유형입니다.
ED_DEVTYPE_VCR 디바이스에는 전체 VCR 기능이 있습니다.

요구 사항

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

추가 정보

오류 및 성공 코드

IAMExtDevice 인터페이스