MFCreateSensorGroup 함수(mfidl.h)

제공된 기호 링크 이름을 기반으로 IMFSensorGroup 인터페이스의 instance 만듭니다.

구문

HRESULT MFCreateSensorGroup(
        LPCWSTR        SensorGroupSymbolicLink,
  [out] IMFSensorGroup **ppSensorGroup
);

매개 변수

SensorGroupSymbolicLink

새 IMFSensorGroup에 대한 기호 링크입니다. 이 이름은 SetupDiGetClassDevs 또는 MFEnumDeviceSources와 같은 디바이스 열거형 API를 통해 또는 DeviceInformation 클래스의 Id 속성을 가져와서 가져올 수 있습니다.

[out] ppSensorGroup

새 IMFSensorGroup에 대한 기호 링크입니다.

반환 값

함수는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_POINTER	제공된 IMFSensorGroup 이 null입니다.
E_INVALIDARG	제공된 LPCWSTR 이 null입니다.

설명

함수가 성공하면 ppSensorGroup 은 유효한 IMFSensorGroup 개체를 가리킵니다. 호출자는 이 인터페이스를 해제해야 합니다.

참고 이 API를 KSCATEGORY_SENSOR_CAMERA 또는 KSCATEGORY_VIDEO_CAMERA 기호 이름으로 사용하는 경우 결과 IMFSensorGroup 개체는 하나의 센서 디바이스만 포함하지만 가상화된 센서 그룹으로 작동합니다. 호출자는 결과 개체를 KSCATEGORY_SENSOR_GROUP 가져온 센서 그룹과 동일한 방식으로 사용할 수 있습니다.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 1607 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	mfidl.h