Compartir a través de

IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE IOCTL (pointofservicedriverinterface.h)

  • Artículo

Esta función de control de E/S se usa para mantener una notificación en un dispositivo cuando se notifica a un cliente que su reclamación en el dispositivo está siendo impugnada por otro cliente.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

No se usa con esta operación; se establece en NULL.

Longitud del búfer de entrada

No se utiliza con esta operación; se establece en 0 (cero).

Búfer de salida

No se usa con esta operación; se establece en NULL.

Longitud del búfer de salida

No se utiliza con esta operación; establecido en 0 (cero)

Bloque de estado

Devuelve TRUE si se ejecuta correctamente; de lo contrario, devuelve FALSE.

Comentarios

Para obtener información de error extendida, llame a GetLastError. En la lista siguiente se muestran los valores de error comunes:

  • STATUS_ACCESS_DENIED: otro cliente reclama actualmente el dispositivo.

  • STATUS_DEVICE_NOT_READY: la biblioteca pos no se ha inicializado correctamente.

Este IOCTL solo funciona si el cliente ha llamado previamente a IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE.

Al controlar este IOCTL, el controlador puede llamar a PosCxRetainDevice. El escritor de controladores no necesita controlar la contención de notificaciones porque la biblioteca PosCx determina quién obtiene la notificación.

Requisitos

Requisito Valor
Header pointofservicedriverinterface.h (include Pointofservicedriverinterface.h)