IWMDeviceManager3::SetDeviceEnumPreference 메서드(mswmdm.h)
SetDeviceEnumPreference 메서드는 디바이스 열거형 기본 설정을 지정합니다.
구문
HRESULT SetDeviceEnumPreference(
[in] DWORD dwEnumPref
);
매개 변수
[in] dwEnumPref
열거형 기본 설정을 지정하는 다음 비트 값 중 하나 이상의 비트 OR 조합을 지정합니다. 각 집합 비트는 해당 확장 동작을 사용하도록 설정하는 반면, 해당 비트가 없을 경우 확장 동작을 사용하지 않도록 설정하고 이전 버전과 호환되는 기본 열거형 동작을 지정합니다. fuPrefs에 대한 가능한 값은 다음 표에 나와 있습니다.
| 값 | Description |
|---|---|
| DO_NOT_VIRTUALIZE_STORAGES_AS_DEVICES | 기본적으로 여러 스토리지 미디어(예: 여러 플래시 메모리 카드)가 포함된 디바이스의 경우 이러한 각 스토리지는 별도의 의사 디바이스로 열거됩니다. 그러나 이 플래그가 설정되면 스토리지는 디바이스로 표시되지 않으며 디바이스만 디바이스로 표시됩니다. 자세한 내용은 설명 부분을 참조하십시오. |
| ALLOW_OUTOFBAND_NOTIFICATION | 이 플래그가 설정되면 서비스 공급자는 창 메시지를 사용하는 것과 같은 추가 메커니즘과 애플리케이션 구현 IWMDMNotification 인터페이스를 호출하는 기본 메커니즘을 통해 디바이스 도착 및 제거를 보낼 수 있습니다. |
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 성공했습니다. |
|
fuPrefs 매개 변수는 지원되지 않는 비트 값을 지정합니다. |
|
메서드는 열거형 작업 후에 호출되었습니다. 열거형 작업 전에 호출해야 합니다. |
설명
이 메서드는 클라이언트가 Windows Media 장치 관리자 기본 디바이스 열거 동작을 재정의하는 기능을 제공합니다. 기본 동작을 재정의하려면 클라이언트 애플리케이션이 Media 장치 관리자 IWMDMDeviceManager3 인터페이스를 쿼리하여 디바이스 관리자 개체를 만든 직후에 이 메서드를 호출해야 합니다. 다른 작업의 결과로 명시적으로 또는 암시적으로 열거형이 발생하기 전에 호출을 수행해야 합니다.
기본 설정 플래그가 설정된 후에는 애플리케이션의 수명(Windows Media 장치 관리자 개체의 수명뿐만 아니라)을 변경할 수 없습니다. 기본 설정 플래그를 변경하려고 하면 오류가 발생합니다. 동일한 플래그 설정을 사용하여 이 메서드를 다시 호출해도 오류가 반환되지 않으며 열거형에도 영향을 미칩니다.
서비스 공급자는 DO_NOT_VIRTUALIZE_STORAGES_AS_DEVICES 플래그를 적용할 수 없습니다. 스토리지가 동일한 디바이스에서 호스트되는지 확인하는 보다 강력한 방법은 IWMDMDevice2::GetCanonicalName을 호출하는 것입니다. 동일한 디바이스의 스토리지는 마지막 "$" 문자 뒤의 최종 숫자를 제외하고 동일한 값을 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | mswmdm.h |