이 항목에서는 WDF(Windows 드라이버 프레임워크) 드라이버가 통합 디바이스 속성 모델을 통해 노출되는 속성을 검색하거나 수정하는 방법을 설명합니다. 나열된 메서드는 UMDF(User-Mode Driver Framework) 버전 2.0 및 KMDF(Kernel-Mode Driver Framework) 버전 1.13부터 사용할 수 있습니다.
KMDF 및 UMDF 드라이버 모두 다음 메서드를 호출할 수 있습니다.
KMDF와 UMDF 드라이버는 모두 WdfDeviceCreate호출하기 전에다음 메서드를 호출할 수 있습니다. WdfDeviceCreate호출하는 방법에 대한 자세한 내용은 프레임워크 디바이스 개체 만들기참조하세요.
WdfDeviceCreate호출한 후 드라이버는 해당 WdfDeviceXxx속성 메서드를 호출하여 디바이스 속성 정보를 가져올 수 있습니다.
위의 -Ex 메서드는 DEVICE_REGISTRY_PROPERTY사용하여 지정할 수 있는 하위 집합 대신 WDF_DEVICE_PROPERTY_DATA 구조를 사용하여 속성을 지정할 수 있다는 점에서 비-Ex 해당 메서드와 다릅니다.
디바이스 속성 데이터를 수신하기 전에 드라이버는 일반적으로 필요한 버퍼 크기를 얻기 위해 WdfXxxQueryProperty 호출합니다. 일부 속성의 경우, 필요한 크기가 반환된 후 드라이버가 Wdf를 호출하고QueryProperty를 다시 호출하는 사이에 데이터 크기가 변경될 수 있습니다. 따라서 드라이버는 반환 상태가 STATUS_BUFFER_TOO_SMALL아닌 동안 실행되는 루프 내에서 WdfXxxQueryProperty를 호출해야 합니다.
필요한 버퍼 크기를 알고 변경되지 않는 경우에만 WdfXxxQueryProperty 사용하는 것이 가장 좋습니다. 이 경우 드라이버는 WdfXxxQueryProperty 한 번만 호출해야 하기 때문입니다. 필요한 버퍼 크기를 알 수 없거나 다른 경우 드라이버는 WdfXxxAllocAndQueryProperty호출해야 합니다.
디바이스 인터페이스 속성에 액세스
UMDF 드라이버는 다음 메서드를 사용하여 통합 속성 모델을 통해 노출되는 디바이스 인터페이스 속성을 검색하거나 수정할 수 있습니다.
디바이스 인터페이스 속성을 검색하거나 수정하려면 KMDF 드라이버가 IoGetDeviceInterfacePropertyData 또는 IoSetDeviceInterfacePropertyData 직접 호출해야 합니다.