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

  • Artigo

Uma função de retorno de chamada de evento EvtSpbControllerIoWrite do driver de controlador SPB grava dados no dispositivo de destino especificado dos buffers fornecidos com a solicitação de gravação.

Sintaxe

EVT_SPB_CONTROLLER_WRITE EvtSpbControllerWrite;

void EvtSpbControllerWrite(
  [in] WDFDEVICE Controller,
  [in] SPBTARGET Target,
  [in] SPBREQUEST Request,
  [in] size_t Length
)
{...}

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 dessa solicitação de E/S. 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.

[in] Request

Um identificador SPBREQUEST para a solicitação de E/S. O driver do controlador SPB deve concluir essa solicitação executando a operação solicitada ou retornando um erro status. Para obter mais informações, consulte Comentários.

[in] Length

O número de bytes a serem gravados no dispositivo de destino.

Retornar valor

Nenhum

Comentários

O SpbCx gerencia a fila de E/S para o controlador SPB. O SpbCx chama a função de retorno de chamada EvtSpbControllerIoWrite do driver do controlador SPB quando um cliente (driver periférico) do controlador SPB envia uma solicitação IRP_MJ_WRITE para um dispositivo de destino anexado ao barramento. O valor do parâmetro Request é um identificador que encapsula essa solicitação.

Um retorno de chamada EvtSpbControllerIoWrite não retorna um valor status. Em vez disso, o driver do controlador SPB indica o status da operação de gravação no status de conclusão para a solicitação de E/S.

Um retorno de chamada EvtSpbControllerIoWrite é assíncrono. Ou seja, a função de retorno de chamada deve iniciar a operação de gravação solicitada e, em seguida, retornar sem esperar a conclusão da operação. Posteriormente, o driver do controlador SPB conclui a solicitação de gravação durante uma DPC de interrupção ou um DPC de temporizador.

Um retorno de chamada EvtSpbControllerIoWrite não retorna um valor status. Em vez disso, o driver do controlador SPB indica o status da operação de gravação no status de conclusão para a solicitação de E/S.

Se a operação de gravação for concluída na íntegra, a função de retorno de chamada deverá definir o status de conclusão como STATUS_SUCCESS. Se o dispositivo de destino indicar que não pode aceitar mais dados antes da conclusão de uma transmissão, o driver deverá definir o status de conclusão como STATUS_SUCCESS e especificar o número de bytes transmitidos.

Se ocorrer um erro de transmissão durante a operação de gravação, o driver deverá definir o status de conclusão na solicitação de E/S para um código de erro apropriado. Nem todos os ônibus fornecem um mecanismo para um dispositivo de destino relatar um erro de transporte ou uma transferência parcialmente concluída, e nem todos os controladores podem detectar essas condições.

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

Exemplos

Para definir uma função de retorno de chamada EvtSpbControllerIoWrite , 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 EvtSpbControllerIoWrite chamada MyEvtSpbControllerIoWrite, use o tipo de função EVT_SPB_CONTROLLER_WRITE, conforme mostrado neste exemplo de código:

EVT_SPB_CONTROLLER_WRITE  MyEvtSpbControllerIoWrite;

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

_Use_decl_annotations_
VOID
  MyEvtSpbControllerIoWrite(
    WDFDEVICE Controller,
    SPBTARGET Target,
    SPBREQUEST Request,
    size_t Length
    )
{ ... }

O tipo de função EVT_SPB_CONTROLLER_WRITE é 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_CONTROLLER_WRITE 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 IRQL <= DISPATCH_LEVEL.

Confira também