Compartilhar via


IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE IOCTL (pointofservicedriverinterface.h)

Essa função de controle de E/S é usada para manter uma declaração em um dispositivo quando um cliente é notificado de que sua declaração no dispositivo está sendo contestada por outro cliente.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Não usado com esta operação; definido como NULL.

Comprimento do buffer de entrada

Não usado com esta operação; definido como 0 (zero).

Buffer de saída

Não usado com esta operação; definido como NULL.

Comprimento do buffer de saída

Não usado com esta operação; definido como 0 (zero)

Bloco de status

Retorna verdadeiro se bem-sucedido; caso contrário, retorna FALSE .

Observações

Para obter informações de erro estendidas, chame GetLastError. A lista a seguir mostra valores de erro comuns:

  • STATUS_ACCESS_DENIED: O dispositivo é atualmente reivindicado por outro cliente.

  • STATUS_DEVICE_NOT_READY: a biblioteca de POS não foi inicializada com êxito.

Esse IOCTL só funcionará se o cliente tiver chamado anteriormente IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE.

Ao lidar com esse IOCTL, o driver pode chamar PosCxRetainDevice. O gravador de driver não precisa lidar com a contenção de declaração porque a biblioteca PosCx determina quem obtém a declaração.

Requisitos

Requisito Valor
cabeçalho pointofservicedriverinterface.h (inclua Pointofservicedriverinterface.h)