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; 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: A declaração não pôde ser retirada do proprietário da declaração atual.

  • STATUS_DEVICE_NOT_READY: a biblioteca de POS não é inicializada.

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

Este 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)