Compartilhar via


HW_COMPLETE_SERVICE_IRP função de retorno de chamada (storport.h)

A rotina HwStorCompleteServiceIrp é chamada quando o adaptador virtual está sendo removido. Quando isso acontece, o miniporto virtual Storport pode concluir todos os IRPs de retorno de chamada reverso recebidos em HwStorCompleteServiceIrp.

Sintaxe

HW_COMPLETE_SERVICE_IRP HwCompleteServiceIrp;

void HwCompleteServiceIrp(
  PVOID DeviceExtension
)
{...}

Parâmetros

DeviceExtension

Um ponteiro para a área de armazenamento por adaptador do driver de miniporta virtual.

Retornar valor

Nenhum

Comentários

O nome HwStorCompleteServiceIrp é um texto de espaço reservado para o nome de rotina real. O protótipo real dessa rotina é definido em Storport.h da seguinte maneira:

typedef
VOID
HW_COMPLETE_SERVICE_IRP (
  _In_ PVOID  DeviceExtension
  );

O driver de porta chama a rotina HwStorCompleteServiceIrpdo driver de miniporta virtual storport em PASSIVE_LEVEL sem manter nenhum bloqueio de rotação. O driver de miniporto virtual conclui o IRP chamando a rotina HwStorCompleteServiceIrp .

Exemplos

Para definir uma função de retorno de chamada HwStorCompleteServiceIrp , 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 escrever drivers para o sistema operacional Windows.

Por exemplo, para definir uma rotina de retorno de chamada HwStorCompleteServiceIrp chamada *&MyHwCompleteServiceIrp, use o tipo HW_COMPLETE_SERVICE_IRP conforme mostrado neste exemplo de código:

HW_COMPLETE_SERVICE_IRP MyHwCompleteServiceIrp;

Em seguida, implemente sua rotina de retorno de chamada da seguinte maneira:

_Use_decl_annotations_
VOID
MyHwCompleteServiceIrp (
  _In_ PVOID  DeviceExtension
  );
  {
      ...
  }

O tipo de função HW_COMPLETE_SERVICE_IRP é definido no arquivo de cabeçalho Storport.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 HW_COMPLETE_SERVICE_IRP 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 para drivers storport. Para obter informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho storport.h (inclua Storport.h)

Confira também

HwStorProcessServiceRequest

StorPortCompleteServiceIrp