Compartilhar via


EVT_POS_CX_DEVICE_REMOTE_RETAIN função de retorno de chamada (poscx.h)

O retorno de chamada EVT_POS_CX_DEVICE_REMOTE_RETAIN é chamado sempre que PosCx tenta manter uma declaração em um dispositivo de rede e permite que o driver faça trabalho adicional. Normalmente, esse retorno de chamada é usado apenas com dispositivos conectados à rede que exigem lógica adicional para lidar com transições de propriedade.

Sintaxe

EVT_POS_CX_DEVICE_REMOTE_RETAIN EvtPosCxDeviceRemoteRetain;

NTSTATUS EvtPosCxDeviceRemoteRetain(
  [in] WDFDEVICE device,
  [in] ULONG deviceInterfaceTag
)
{...}

Parâmetros

[in] device

Um identificador para um objeto de dispositivo de estrutura que representa o dispositivo.

[in] deviceInterfaceTag

Um identificador usado para especificar qual interface está sendo retida em um dispositivo de várias funções. Para um dispositivo de interface única, esse valor deve ser 0.

Retornar valor

Se a operação for bem-sucedida, a função de retorno de chamada deverá retornar STATUS_SUCCESS ou outro valor status para o qual NT_SUCCESS(status) é igual a TRUE.

Se o driver não conseguir concluir a transação de retenção remota, ele deverá retornar STATUS_ACCESS_DENIED para que a falha seja exibida até o aplicativo.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho poscx.h (inclua Poscx.h)