Função ObfReferenceObject (wdm.h)

  • Artigo

A rotina ObfReferenceObject incrementa a contagem de referência para o objeto fornecido.

Sintaxe

LONG_PTR ObfReferenceObject(
  [in] PVOID Object
);

Parâmetros

[in] Object

Ponteiro para o objeto . O chamador obteve esse parâmetro quando criou o objeto ou de uma chamada anterior para ObReferenceObjectByHandle depois que ele abriu o objeto.

Retornar valor

ObfReferenceObject retorna um valor reservado para uso do sistema. Os drivers devem tratar esse valor como VOID.

Comentários

ObfReferenceObject simplesmente incrementa a contagem de referência de ponteiro para um objeto, sem fazer nenhuma verificação de acesso no objeto fornecido, como ObReferenceObjectByHandle e ObReferenceObjectByPointer fazem.

ObfReferenceObject impede a exclusão do objeto pelo menos até que o driver chame posteriormente seu objeto recíproco, ObDereferenceObject, ou feche o objeto fornecido. O chamador deve diminuir a contagem de referência com ObDereferenceObject assim que for feito com o objeto .

Quando a contagem de referência de um objeto atinge zero, um componente do modo kernel pode remover o objeto do sistema. No entanto, um driver pode remover apenas os objetos que ele criou e um driver nunca deve tentar remover nenhum objeto que ele não tenha criado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), TargetRelationNeedsRef(wdm)

Confira também

ObDereferenceObject

ObReferenceObjectByHandle

ObReferenceObjectByPointer

ZwClose