IWDFDevice::RetrieveDevicePropertyStore 메서드(wudfddi.h)

아티클
02/07/2025

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에는 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10에서는 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF시작 .]을 참조하세요.

RetrieveDevicePropertyStore 메서드는 드라이버가 레지스트리에 액세스하는 데 사용할 수 있는 속성 저장소 인터페이스를 검색합니다.

통사론

HRESULT RetrieveDevicePropertyStore(
  [in, optional]  PCWSTR                            pcwszServiceName,
  [in]            WDF_PROPERTY_STORE_RETRIEVE_FLAGS Flags,
  [out]           IWDFNamedPropertyStore            **ppPropStore,
  [out, optional] WDF_PROPERTY_STORE_DISPOSITION    *pDisposition
);

매개 변수

[in, optional] pcwszServiceName

디바이스 속성 저장소의 이름을 나타내는 NULL종결 문자열에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다. 드라이버가 디바이스 속성 저장소의 이름을 제공하지 않는 경우 드라이버는 NULL 전달할 수 있습니다.

[in] Flags

디바이스 속성 저장소를 검색하는 방법을 식별하는 WDF_PROPERTY_STORE_RETRIEVE_FLAGS형식화된 값입니다.

[out] ppPropStore

IWDFNamedPropertyStore 인터페이스에 대한 포인터를 수신하는 버퍼에 대한 포인터입니다. 드라이버는 이 인터페이스를 사용하여 레지스트리의 값에 액세스합니다.

[out, optional] pDisposition

프레임워크가 디바이스 속성 저장소를 만들었는지 또는 디바이스 속성 저장소가 이미 있는지 여부를 식별하는 WDF_PROPERTY_STORE_DISPOSITION형식화된 값을 수신하는 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다. 드라이버에 처리 정보가 필요하지 않은 경우 드라이버는 NULL 전달할 수 있습니다.

반환 값

RetrieveDevicePropertyStore 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다.

발언

호출자는 속성 저장소를 완료한 후 IWDFNamedPropertyStore 인터페이스의 Release 메서드를 호출해야 합니다.

자세한 내용은 UMDF 기반 드라이버레지스트리 사용을 참조하세요.

요구 사항

요구	값
지원 종료	UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼	바탕 화면
최소 UMDF 버전	1.5
헤더	wudfddi.h(Wudfddi.h 포함)
DLL	WUDFx.dll