IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// pointofservicedriverinterface.h

// CTL_CODE(0x0054, 0x005, METHOD_BUFFERED, FILE_WRITE_ACCESS)
#define IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE 0x00548014
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (ni-pointofservicedriverinterface-ioctl_point_of_service_retain_device)

IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE IOCTL

Description

This I/O control function is used to keep a claim on a device when a client is notified that its claim on the device is being contested by another client.

Parameters

Major code

Input buffer

Not used with this operation; set to NULL.

Input buffer length

Not used with this operation; set to 0 (zero).

Output buffer

Not used with this operation; set to NULL.

Output buffer length

Not used with this operation; set to 0 (zero)

Input/output buffer

Input/output buffer length

Status block

Returns TRUE if successful; otherwise, returns FALSE.

Remarks

To get extended error information, call GetLastError. The following list shows common error values:

This IOCTL only works if the client has previously called IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE.

When handling this IOCTL, the driver can call PosCxRetainDevice. The driver writer does not need to handle claim contention because the PosCx library determines who gets the claim.