WdfDeviceSetCharacteristics 함수(wdfdevice.h)

[KMDF에만 적용]

WdfDeviceSetCharacteristics 메서드는 지정된 디바이스에 대한 디바이스 특성을 설정합니다.

구문

void WdfDeviceSetCharacteristics(
  [in] WDFDEVICE Device,
  [in] ULONG     DeviceCharacteristics
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

[in] DeviceCharacteristics

디바이스 특성을 나타내는 ORed 시스템 정의 상수로 구성된 값입니다. 자세한 내용은 DEVICE_OBJECT 구조체의 Characteristics 멤버를 참조하세요.

반환 값

없음

설명

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

WdfDeviceCreate를 호출하기 전에 EvtDriverDeviceAdd 콜백 함수에서 WdfDeviceInitSetCharacteristics 메서드를 호출하여 디바이스 특성을 설정해야 합니다. 드라이버가 EvtDriverDeviceAdd 콜백 함수가 반환될 때까지 디바이스의 특성을 확인할 수 없는 경우 드라이버는 일반적으로 EvtDevicePrepareHardware 콜백 함수에서 WdfDeviceSetCharacteristics를 호출해야 합니다.

WdfDeviceSetCharacteristics에 대한 각 호출은 이전 호출의 설정을 덮어씁니다.

예제

다음 코드 예제에서는 지정된 디바이스의 FILE_REMOVABLE_MEDIA 특성을 설정합니다.

WdfDeviceSetCharacteristics(
                            Device,
                            FILE_REMOVABLE_MEDIA
                            );

요구 사항

요구 사항
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfdevice.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL <=DISPATCH_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics