Compartir a través de


IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE IOCTL (pointofservicedriverinterface.h)

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 notificació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; establezca en null.

Longitud del búfer de entrada

No se usa con esta operación; establezca en 0 (cero).

Búfer de salida

No se usa con esta operación; establezca en null.

Longitud del búfer de salida

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

Bloque de estado

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

Observaciones

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 anteriormente 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
encabezado de pointofservicedriverinterface.h (include Pointofservicedriverinterface.h)