Compartilhar via


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

O retorno de chamada EVT_POS_CX_DEVICE_REMOTE_CLAIM é chamado quando o dispositivo está fazendo a transição de não solicitado para declarado 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.

EVT_POS_CX_DEVICE_REMOTE_CLAIM e EVT_POS_CX_DEVICE_REMOTE_RELEASE adicionar suporte para dispositivos remotos que lidam com sua própria semântica de declaração.

Sintaxe

EVT_POS_CX_DEVICE_REMOTE_CLAIM EvtPosCxDeviceRemoteClaim;

NTSTATUS EvtPosCxDeviceRemoteClaim(
  [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 reivindicada 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 declaraçã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)

Confira também

EVT_POS_CX_DEVICE_REMOTE_RELEASE