wiasReadPropBin-Funktion (wiamdef.h)

Artikel
03/01/2024

Die wiasReadPropBin-Funktion ruft einen Binärdateneigenschaftswert aus einem WIA-Element ab.

Syntax

HRESULT wiasReadPropBin(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           BYTE   **ppbVal,
  [out, optional] BYTE   **ppbValOld,
                  BOOL   bMustExist
);

Parameter

[in] pWiasContext

Zeiger auf einen WIA-Elementkontext.

propid

Gibt den Eigenschaftenbezeichner an.

[out] ppbVal

Zeiger auf einen Speicherspeicherort, der die Adresse eines Puffers empfängt, der von dieser Funktion zugeordnet wird. Bei der Rückgabe enthält der Puffer die Binärdaten der Eigenschaft.

[out, optional] ppbValOld

Zeiger auf einen Speicherort im Arbeitsspeicher, der die Adresse eines vom Minitreiber zugeordneten Puffers empfängt. Bei der Rückgabe enthält der Puffer den vorherigen Wert der Binärdaten der Eigenschaft. Wenn diese Informationen nicht benötigt werden, kann dieser Parameter auf NULL festgelegt werden.

bMustExist

Gibt an, ob die Eigenschaft vorhanden sein muss. Wenn dieser Wert auf TRUE festgelegt ist, muss die -Eigenschaft vorhanden sein. wenn auf FALSE festgelegt ist, muss die -Eigenschaft nicht vorhanden sein.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen COM-Standardfehler oder einen der WIA-Fehlercodes zurück.

Hinweise

Diese Funktion weist einen Puffer zu und speichert seine Adresse im ppbVal-Parameter . Der Minidriver muss den Puffer durch Aufrufen von CoTaskMemFree freigeben.