wiasQueueEvent-Funktion (wiamdef.h)

Die wiasQueueEvent Funktion informiert den Dienst darüber, dass das Gerät ein Ereignis generiert hat.

HRESULT wiasQueueEvent(
  [in]           BSTR       bstrDeviceId,
  [in]           const GUID *pEventGUID,
  [in, optional] BSTR       bstrFullItemName
);

[in] bstrDeviceId

Gibt die Geräte-ID an. Dies ist der Wert, der an den Minidriver im Aufruf der IWiaMiniDrv::d rvInitializeWia-Methode übergeben wird.

[in] pEventGUID

Zeigen Sie auf einen Puffer, der die GUID für das Ereignis enthält.

[in, optional] bstrFullItemName

Gibt den vollständigen Elementnamen einschließlich Pfadinformationen an.

Bei Erfolg gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, wird ein STANDARDMÄßIGer COM-Fehler oder eine der WIA-Fehlercodeszurückgegeben.

Diese Methode sollte verwendet werden, wenn das Gerät signalisieren muss, dass ein Ereignis eines Typs aufgetreten ist. Das Gerät führt dies durch Platzieren des Ereignisses in die Ereigniswarteschlange aus. Wenn z. B. eine Kamera ein neues Bild einnimmt, sollte ein WIA_EVENT_ITEM_CREATED Ereignis generiert werden, nachdem ein neues Treiberelement zur Struktur hinzugefügt wurde. Die Kamera kann dieses Ereignis auf diese Weise in der Ereigniswarteschlange platzieren:

hr = wiasQueueEvent(bstrMyDeviceId,
                    &WIA_EVENT_ITEM_CREATED,
                    bstrDescriptionString);

Eine vollständige Liste der WIA-Ereignisbezeichner finden Sie in der Windows SDK-Dokumentation.

IWiaMiniDrv::d rvInitializeWia