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를 호출하여 버퍼를 해제해야 합니다.

요구 사항

추가 정보

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropLong

wiasReadPropStr

wiasWritePropBin