Compartilhar via


IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE IOCTL (pointofservicedriverinterface.h)

A função de controle de E/S declara o dispositivo para acesso exclusivo.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Não é usado com esta operação, defina 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, defina como NULL.

Comprimento do buffer de saída

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

Bloco de status

Retorna TRUE se tiver êxito; caso contrário, retornará FALSE.

Comentários

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

  • STATUS_ACCESS_DENIED: a declaração não pôde ser retirada do proprietário da declaração atual.

  • STATUS_DEVICE_NOT_READY: a biblioteca pos não é inicializada.

  • STATUS_PENDING: a solicitação de declaração foi enfileirada.

Esse IOCTL é tratado pela biblioteca PosCx. O gravador de driver não precisa lidar com esse IOCTL. Em vez disso, chame PosCxClaimDevice. Se o dispositivo POS já for reivindicado por outro cliente, o driver do dispositivo POS será responsável por notificar o proprietário da declaração usando um evento ReleaseDeviceRequested e aguardar que o proprietário da declaração mantenha sua declaração dentro de 50 milissegundos. Se a declaração não for reafirmada, a declaração do proprietário da declaração atual será automaticamente revogada e concedida ao cliente desafiador.

Requisitos

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