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

아티클
02/27/2024

[경고: 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