Partilhar 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 passado como membro Contexto da estrutura interface da interface para a interface.

Valor de retorno

Nenhum

Observações

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 de 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
da Plataforma de Destino Área de trabalho
cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h)

Consulte também

de INTERFACE do

IRP_MN_QUERY_INTERFACE

InterfaceDereference