Compartilhar via


Função IoGetAttachedDeviceReference (ntifs.h)

A rotina IoGetAttachedDeviceReference retorna um ponteiro para o objeto de dispositivo de nível mais alto em uma pilha de driver e incrementa a contagem de referência nesse objeto.

Sintaxe

PDEVICE_OBJECT IoGetAttachedDeviceReference(
  [in] PDEVICE_OBJECT DeviceObject
);

Parâmetros

[in] DeviceObject

Ponteiro para o objeto do dispositivo para o qual o objeto de dispositivo mais alto anexado é recuperado.

Valor de retorno

IoGetAttachedDeviceReference retorna um ponteiro para o objeto de dispositivo de nível mais alto em uma pilha de objetos de dispositivo anexados depois de incrementar a contagem de referência no objeto.

Observações

Se o objeto do dispositivo em DeviceObject não tiver nenhum objeto de dispositivo anexado a ele, DeviceObject e o ponteiro retornado serão iguais.

Os gravadores de driver de dispositivo devem garantir que, quando tiverem concluído todas as operações que exigem que eles façam essa chamada, chamem ObDereferenceObject com o ponteiro do objeto do dispositivo retornado por essa rotina. A falha ao fazer isso impedirá que o sistema libere ou exclua o objeto do dispositivo devido a uma contagem de referência pendente.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000
da Plataforma de Destino Universal
cabeçalho ntifs.h (incluem Wdm.h, Ntddk.h, Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
regras de conformidade de DDI DanglingDeviceObjectReference(wdm), HwStorPortProhibitedDIs(storport)

Consulte também

ObDereferenceObject