Compartilhar via


Função IoGetAttachedDevice (ntifs.h)

A rotina IoGetAttachedDevice retorna um ponteiro para o objeto de dispositivo de nível mais alto associado ao dispositivo especificado.

Sintaxe

PDEVICE_OBJECT IoGetAttachedDevice(
  [in] PDEVICE_OBJECT DeviceObject
);

Parâmetros

[in] DeviceObject

Um ponteiro para o objeto do dispositivo para o qual o dispositivo mais alto anexado deve ser retornado.

Valor de retorno

IoGetAttachedDevice retorna o dispositivo de nível mais alto anexado ao dispositivo especificado.

Observações

Se o objeto do dispositivo especificado por DeviceObject não tiver outros objetos de dispositivo anexados a ele, DeviceObject e o ponteiro retornado serão iguais.

IoGetAttachedDevice difere de IoGetAttachedDeviceReference nos seguintes aspectos:

  • IoGetAttachedDevice não incrementa a contagem de referência no objeto do dispositivo. (Portanto, nenhuma chamada correspondente para ObDereferenceObject é necessária.)

  • Os chamadores do IoGetAttachedDevice devem garantir que nenhum objeto de dispositivo seja adicionado ou removido da pilha enquanto IoGetAttachedDevice estiver em execução. Os chamadores que não podem fazer isso devem usar IoGetAttachedDeviceReference.

Requisitos

Requisito Valor
da Plataforma de Destino Universal
cabeçalho ntifs.h (inclua Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Consulte também

IoGetAttachedDeviceReference

ObDereferenceObject