IStillImageW::GetDeviceValue 메서드(sti.h)

IStillImage::GetDeviceValue 메서드는 지정된 스틸 이미지 디바이스와 연결된 레지스트리 정보를 반환합니다.

구문

HRESULT GetDeviceValue(
  [in]      LPWSTR  pwszDeviceName,
  [in]      LPWSTR  pValueName,
  [out]     LPDWORD pType,
  [out]     LPBYTE  pData,
  [in, out] LPDWORD cbData
);

매개 변수

[in] pwszDeviceName

IStillImage::GetSTILaunchInformation 또는 IStillImage::GetDeviceList를 호출하여 가져온 내부 디바이스 이름을 나타내는 문자열에 대한 호출자 제공 포인터입니다.

[in] pValueName

레지스트리 값 이름을 나타내는 문자열에 대한 호출자 제공 포인터입니다.

[out] pType

반환된 레지스트리 값의 데이터 형식을 나타내는 상수를 받습니다.

[out] pData

반환된 값을 받을 버퍼에 대한 호출자 제공 포인터입니다.

[in, out] cbData

pData가 가리키는 버퍼의 호출자 제공 크기(바이트)입니다. 메서드는 반환된 데이터의 크기를 나타내도록 이 값을 수정합니다. 지정된 버퍼 크기가 너무 작으면 메서드는 필요한 버퍼 크기를 제공하고 오류 코드를 반환합니다.

반환 값

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

설명

IStillImage::GetDeviceValue 메서드의 목적은 현재 스틸 이미지 디바이스에 대한 디바이스별 레지스트리 항목에 할당된 값을 반환하는 것입니다. 메서드는 RegQueryValueEx를 호출합니다(Microsoft Windows SDK 설명서에 설명되어 있습니다).

IStillImage::GetDeviceValue 메서드는 ANSI 또는 유니코드 문자열을 반환할 수 있습니다. 코드가 유니코드가 정의된 유니코드로 빌드된 경우에만 유니코드 문자열을 반환할 수 있습니다.

IStillImage::GetDeviceValue를 호출하기 전에 IStillImage COM 인터페이스의 클라이언트는 IStillImage::StiCreateInstance를 호출하여 IStillImage 인터페이스 포인터를 가져와야 합니다.

요구 사항

추가 정보

IStillImage::SetDeviceValue

IStillImageW