PcUnregisterIoTimeout function

The PcUnregisterIoTimeout function unregisters a driver-supplied I/O-timer callback routine for a specified device object.

Note  This function is deprecated for Windows 8 and later versions of Windows. For Windows on Arm systems, this function is commented out in the PortCls class driver and is inaccessible.

Syntax


NTSTATUS PcUnregisterIoTimeout(
  _In_  PDEVICE_OBJECT pDeviceObject,
  _In_  PIO_TIMER_ROUTINE pTimerRoutine,
  _In_  PVOID pContext
);

Parameters

pDeviceObject [in]

Pointer to the same device object that the driver supplied when it previously called PcRegisterIoTimeout. The device object is a system structure of type DEVICE_OBJECT.

pTimerRoutine [in]

Pointer to the same I/O-timer callback routine that the driver supplied when it previously called PcRegisterIoTimeout

pContext [in]

Pointer to the same driver-determined context that the driver supplied when it previously called PcRegisterIoTimeout

Return value

PcUnregisterIoTimeout returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code. The following table shows some of the possible error codes.

Return codeDescription
STATUS_NOT_FOUND

Indicates that no timer callback with the same device object, callback routine, and context is currently registered.

 

Remarks

This call succeeds only if a time-out callback with the same device object, timer routine, and context was previously registered with a call to the PcRegisterIoTimeout function.

Requirements

Version

The PortCls system driver implements the PcUnregisterIoTimeout function in Microsoft Windows 98/Me and in Windows 2000 and later operating systems.

Header

Portcls.h (include Portcls.h)

Library

Portcls.lib

IRQL

PASSIVE_LEVEL

See also

PcRegisterIoTimeout
DEVICE_OBJECT

 

 

Send comments about this topic to Microsoft

顯示:
© 2014 Microsoft