Compartilhar via


PINTERFACE_REFERENCE função de retorno de chamada (wdm.h)

A rotina InterfaceReference incrementa a contagem de referência em uma interface definida pelo driver.

Sintaxe

PINTERFACE_REFERENCE PinterfaceReference;

void PinterfaceReference(
  [in] PVOID Context
)
{...}

Parâmetros

[in] Context

Um ponteiro para informações de contexto específicas da interface. O chamador passa o valor que é passado como o membro contextual da estrutura interface para a interface.

Retornar valor

Nenhum

Comentários

Observe que esse é um contrato por interface, portanto, não há requisitos gerais de IRQL em relação a InterfaceReference/Dereference.

Você pode usar a rotina InterfaceDereference para diminuir a contagem de referência para a interface.

O driver que exporta a interface é responsável por chamar InterfaceReference para incrementar a contagem de referência antes que o driver exporte a interface. Por exemplo, o driver que inicialmente exportou a interface em resposta a uma solicitação IRP_MN_QUERY_INTERFACE chama InterfaceReference. Além disso, um driver que passa um ponteiro para a interface para outro driver deve chamar InterfaceReference.

Observe que a rotina InterfaceReference é um contrato por interface, portanto, não há requisitos gerais de IRQL para chamá-lo.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h)

Confira também

INTERFACE

IRP_MN_QUERY_INTERFACE

InterfaceDereference