wiasReadPropBin 함수(wiamdef.h)
wiasReadPropBin 함수는 WIA 항목에서 이진 데이터 속성 값을 검색합니다.
구문
HRESULT wiasReadPropBin(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BYTE **ppbVal,
[out, optional] BYTE **ppbValOld,
BOOL bMustExist
);
매개 변수
[in] pWiasContext
WIA 항목 컨텍스트에 대한 포인터입니다.
propid
속성 식별자를 지정합니다.
[out] ppbVal
이 함수에서 할당한 버퍼의 주소를 받는 메모리 위치에 대한 포인터입니다. 반환 시 버퍼에는 속성의 이진 데이터가 포함됩니다.
[out, optional] ppbValOld
미니 드라이버에서 할당한 버퍼의 주소를 수신하는 메모리 위치에 대한 포인터입니다. 반환 시 버퍼에는 속성의 이진 데이터의 이전 값이 포함됩니다. 이 정보가 필요하지 않은 경우 이 매개 변수를 NULL로 설정할 수 있습니다.
bMustExist
속성이 있어야 하는지 여부를 나타냅니다. TRUE로 설정하면 속성이 있어야 합니다. FALSE로 설정하면 속성이 존재하지 않아도됩니다.
반환 값
성공하면 함수는 S_OK 반환합니다.
함수가 실패하면 표준 COM 오류 또는 WIA 오류 코드 중 하나가 반환됩니다.
설명
이 함수는 버퍼를 할당하고 해당 주소를 ppbVal 매개 변수에 저장합니다. 미니 드라이버는 CoTaskMemFree를 호출하여 버퍼를 해제해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | wiamdef.h(Wiamdef.h 포함) |
| 라이브러리 | Wiaservc.lib |
| DLL | Wiaservc.dll |