wiauGetValidFormats-Funktion (wiautil.h)

Artikel
02/27/2024

Die wiauGetValidFormats-Funktion ruft die IWiaMiniDrv::d rvGetWiaFormatInfo-Methode auf und erstellt eine Liste gültiger Formate unter Verwendung eines angegebenen Tymed-Werts.

Syntax

HRESULT wiauGetValidFormats(
  [in]  IWiaMiniDrv *pDrv,
  [in]  BYTE        *pWiasContext,
        LONG        TymedValue,
  [out] int         *pNumFormats,
  [out] GUID        **ppFormatArray
);

Parameter

[in] pDrv

Zeigt auf das WIA-Minitreiberobjekt. Dieser Parameter sollte auf diesen Parameter festgelegt werden.

[in] pWiasContext

Zeiger auf einen WIA-Elementkontext.

TymedValue

Gibt den tymed-Wert an, nach dem gesucht werden soll.

[out] pNumFormats

Zeiger auf einen Speicherort im Arbeitsspeicher, der die Anzahl der Formate empfängt.

[out] ppFormatArray

Zeiger auf einen Speicherort im Arbeitsspeicher, der die Adresse des Arrays von Format-GUIDs empfängt.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück. Wenn die Funktion fehlschlägt, wird ein COM-Standardfehler zurückgegeben.

Hinweise

Der Aufrufer dieser Funktion ist dafür verantwortlich, das Formatarray mithilfe des delete[] -Operators frei zu geben.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	wiautil.h (wiautil.h einschließen)

Freigeben über