PcUnregisterIoTimeout-Funktion (portcls.h)

  • Artikel

Die PcUnregisterIoTimeout-Funktion hebt die Registrierung einer vom Treiber bereitgestellten I/O-Timer-Rückrufroutine für ein angegebenes Geräteobjekt auf.

Hinweis Diese Funktion ist für Windows 8 und höhere Versionen von Windows veraltet. Bei Windows auf Arm-Systemen ist diese Funktion im PortCls-Klassentreiber auskommentiert und kann nicht zugegriffen werden.
 

Syntax

PORTCLASSAPI NTSTATUS PcUnregisterIoTimeout(
  [in] PDEVICE_OBJECT    pDeviceObject,
  [in] PIO_TIMER_ROUTINE pTimerRoutine,
  [in] PVOID             pContext
);

Parameter

[in] pDeviceObject

Zeiger auf das gleiche Geräteobjekt, das der Treiber bereitgestellt hat, als er zuvor PcRegisterIoTimeout aufgerufen hat. Das Geräteobjekt ist eine Systemstruktur vom Typ DEVICE_OBJECT.

[in] pTimerRoutine

Zeiger auf dieselbe E/A-Timer-Rückrufroutine, die der Treiber bereitgestellt hat, als er zuvor PcRegisterIoTimeout aufgerufen hat

[in] pContext

Zeiger auf denselben treiberbestimmten Kontext, den der Treiber bereitgestellt hat, als er zuvor PcRegisterIoTimeout aufgerufen hat

Rückgabewert

PcUnregisterIoTimeout gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. In der folgenden Tabelle sind einige der möglichen Fehlercodes aufgeführt.

Rückgabecode Beschreibung
STATUS_NOT_FOUND
 Gibt an, dass derzeit kein Timerrückruf mit demselben Geräteobjekt, derselben Rückrufroutine und demselben Kontext registriert ist.

Hinweise

Dieser Aufruf ist nur erfolgreich, wenn ein Timeoutrückruf mit demselben Geräteobjekt, derselben Zeitgeberroutine und demselben Kontext zuvor mit einem Aufruf der PcRegisterIoTimeout-Funktion registriert wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Der PortCls-Systemtreiber implementiert die Funktion PcUnregisterIoTimeout in Microsoft Windows 98/Me und windows 2000 und höher.
Zielplattform Universell
Header portcls.h (portcls.h einschließen)
Bibliothek Portcls.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

DEVICE_OBJECT

PcRegisterIoTimeout