Edit

Share via

PosCxClaimDevice function (poscx.h)

  • Article

PosCxClaimDevice is called to claim a device for exclusive use.

The caller should call PosCxReleaseDevice when the device is no longer needed.

If the device is already claimed, the caller must wait until access is granted.

Syntax

NTSTATUS PosCxClaimDevice(
  [in] WDFDEVICE  device,
  [in] WDFREQUEST request
);

Parameters

[in] device

A handle to a framework device object that represents the device.

[in] request

A handle to a framework request object that represents the request. This request must come from a WDF IO queue.

Return value

Possible return values are:

Value Description
STATUS_SUCCESS The device was successfully claimed.
STATUS_PENDING The claim request was queued.
STATUS_DEVICE_NOT_READY The PosCx library was not successfully initialized.
STATUS_ACCESS_DENIED The current owner has retained device ownership.

Requirements

Requirement Value
Target Platform Windows
Header poscx.h (include Poscx.h)