SerCx2CompleteWait-Funktion (sercx.h)

Artikel
10/30/2024

Die SerCx2CompleteWait Methode benachrichtigt Version 2 der seriellen Framework-Erweiterung (SerCx2), dass ein Ereignis in der aktuellen Wartemaske aufgetreten ist.

Syntax

void SerCx2CompleteWait(
  [in] WDFDEVICE Device,
  [in] ULONG     Event
);

Parameter

[in] Device

Ein WDFDEVICE-Handle für das Framework-Geräteobjekt, das den seriellen Controller darstellt. Der serielle Controllertreiber hat dieses Objekt in seiner EvtDriverDeviceAdd Rückruffunktion erstellt. Weitere Informationen finden Sie unter SerCx2InitializeDevice.

[in] Event

Der Ereignistyp, der den aktuellen Wartevorgang beendet. Dieser Parameter ist ein Warteformatwert. Jeder Ereignistyp entspricht einem bestimmten Bit im Warteformat. Dieses Bit wird so festgelegt, dass das entsprechende Ereignis aufgetreten ist. Weitere Informationen zu den Ereignistypen, die durch eine Wartemaske angegeben werden können, finden Sie unter SERIAL_EV_XXX.

Rückgabewert

Nichts

Bemerkungen

Wenn SerCx2 eine IOCTL_SERIAL_SET_WAIT_MASK Anforderung von einem Client empfängt, ruft der Anforderungshandler in SerCx2 den EvtSerCx2SetWaitMask Rückruffunktion auf, um den seriellen Controllertreiber darüber zu informieren, dass sich das Warteformat geändert hat.

Wenn ein Ereignis in der neuen Wartemaske auftritt, ruft der Treiber SerCx2CompleteWait- auf, um SerCx2 des Ereignisses zu benachrichtigen. Wenn eine zuvor gesendete IOCTL_SERIAL_WAIT_ON_MASK Anforderung zum Zeitpunkt des SerCx2CompleteWait-Aufrufs in SerCx2 aussteht, schließt SerCx2 diese Anforderung mit einem Ausgabewarteformat ab, das angibt, welches Ereignis aufgetreten ist. Andernfalls speichert SerCx2 das Ereignis in seinem internen Ereignisverlauf vor einer zukünftigen IOCTL_SERIAL_WAIT_ON_MASK Anforderung.