MFCreateDeviceSourceActivate 함수(mfidl.h)

하드웨어 캡처 디바이스를 나타내는 활성화 개체를 만듭니다.

구문

HRESULT MFCreateDeviceSourceActivate(
  [in]  IMFAttributes *pAttributes,
  [out] IMFActivate   **ppActivate
);

[in] pAttributes

디바이스를 선택하는 데 사용되는 특성 저장소의 IMFAttributes 인터페이스에 대한 포인터입니다. 설명 부분을 참조하세요.

[out] ppActivate

IMFActivate 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다.

없음

이 함수는 하드웨어 디바이스에 대한 미디어 원본을 만드는 데 사용할 수 있는 활성화 개체를 만듭니다. 미디어 원본 자체를 만들려면 IMFActivate::ActivateObject를 호출합니다.

pAttributes 매개 변수는 특성 저장소를 지정합니다. 특성 저장소를 만들려면 MFCreateAttributes 함수를 호출합니다 . 디바이스 유형(오디오 또는 비디오)을 지정하는 MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE 특성을 설정해야 합니다.

오디오 캡처 디바이스의 경우 필요에 따라 다음 특성 중 하나를 설정합니다.

attribute	Description
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID	오디오 캡처 디바이스의 오디오 엔드포인트 ID를 지정합니다.
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE	디바이스 역할을 지정합니다. 이 특성이 설정된 경우 함수는 해당 디바이스 역할에 대한 기본 오디오 캡처 디바이스를 사용합니다. 이 특성을 MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID 특성과 결합하지 마세요.

두 특성을 모두 지정하지 않으면 함수는 eCommunications 역할에 대한 기본 오디오 캡처 디바이스를 선택합니다.

비디오 캡처 디바이스의 경우 다음 특성을 설정해야 합니다.

attribute	Description
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK	디바이스에 대한 기호 링크를 지정합니다.