EVT_SPB_TARGET_DISCONNECT função de retorno de chamada (spbcx.h)

Artigo
08/07/2023

Uma função de retorno de chamada de evento EvtSpbTargetDisconnect do driver SPB fecha uma conexão com um dispositivo de destino que foi aberto anteriormente por uma chamada para a função de retorno de chamada de evento EvtSpbTargetConnect do driver.

Sintaxe

EVT_SPB_TARGET_DISCONNECT EvtSpbTargetDisconnect;

void EvtSpbTargetDisconnect(
  [in] WDFDEVICE Controller,
  [in] SPBTARGET Target
)
{...}

Parâmetros

[in] Controller

Um identificador WDFDEVICE para o objeto de dispositivo de estrutura que representa o controlador SPB.

[in] Target

Um identificador SPBTARGET para o destino a ser fechado. O destino é um dispositivo periférico ou uma porta anexada ao barramento. A extensão da estrutura SPB (SpbCx) atribuiu anteriormente esse identificador ao destino no retorno de chamada EvtSpbTargetConnect que abriu a conexão com o destino.

Retornar valor

Nenhum

Comentários

A implementação dessa função pelo driver do controlador SPB é opcional.

O SpbCx gerencia a fila de E/S para o controlador SPB. Se o driver do controlador SPB registrar uma função de retorno de chamada EvtSpbTargetDisconnect , o SpbCx chamará essa função quando um cliente (driver periférico) do driver do controlador enviar uma solicitação IRP_MJ_CLOSE para fechar um identificador SPBTARGET. Esse identificador representa uma conexão com um dispositivo de destino no barramento que o cliente abriu em uma solicitação de IRP_MJ_CREATE anterior. Se a função EvtSpbTargetDisconnect retornar um código de erro, o SpbCx falhará na solicitação de IRP_MJ_CLOSE .

A função EvtSpbTargetDisconnect é chamada de forma síncrona do contexto do thread de fechamento do cliente após o término de todas as operações de E/S iniciadas pelo cliente e depois que o cliente desbloqueou o controlador (se o cliente bloqueou anteriormente o controlador).

Se o driver do controlador SPB alocou solicitações de E/S e as enviou para o driver mais baixo na cadeia de solicitações de E/S para o dispositivo de destino, a função EvtSpbTargetDisconnect deverá cancelar essas solicitações antes de retornar.

As rotinas de retorno de chamada DispatchCleanup e CreateProcessNotifyEx de um driver de cliente podem ser chamadas a qualquer momento após o retorno de chamada EvtSpbTargetDisconnect retornar. Quando o processo do driver do cliente é encerrado, sua rotina CreateProcessNotifyEx é chamada pouco antes do último thread para sair do processo ser destruído.

Para registrar uma função de retorno de chamada EvtSpbTargetDisconnect , chame o método SpbDeviceInitialize .

Exemplos

Para definir uma função de retorno de chamada EvtSpbTargetDisconnect , primeiro você deve fornecer uma declaração de função que identifique o tipo de função de retorno de chamada que você está definindo. O Windows fornece um conjunto de tipos de função de retorno de chamada para drivers. Declarar uma função usando os tipos de função de retorno de chamada ajuda a Análise de Código para Drivers, SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação a encontrar erros e é um requisito para gravar drivers para o sistema operacional Windows.

Por exemplo, para definir uma função de retorno de chamada EvtSpbTargetDisconnect chamada MyEvtSpbTargetDisconnect, use o tipo de função EVT_SPB_TARGET_DISCONNECT, conforme mostrado neste exemplo de código:

EVT_SPB_TARGET_DISCONNECT  MyEvtSpbTargetDisconnect;

Em seguida, implemente a função de retorno de chamada da seguinte maneira:

_Use_decl_annotations_
VOID
  MyEvtSpbTargetDisconnect(
    WDFDEVICE Controller,
    SPBTARGET Target
    )
{ ... }

O tipo de função EVT_SPB_TARGET_DISCONNECT é definido no arquivo de cabeçalho Spbcx.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação Use_decl_annotations à sua definição de função. A anotação Use_decl_annotations garante que as anotações aplicadas ao tipo de função EVT_SPB_TARGET_DISCONNECT no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers KMDF. Para obter mais informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte começando com Windows 8.
Plataforma de Destino	Área de Trabalho
Cabeçalho	spbcx.h
IRQL	Chamado em PASSIVE_LEVEL.