Função IoGetAttachedDevice (ntifs.h)

  • Artigo

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 anexado mais alto deve ser retornado.

Retornar valor

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

Comentários

Se o objeto de dispositivo especificado por DeviceObject não tiver nenhum outro objeto de dispositivo anexado 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 de IoGetAttachedDevice devem garantir que nenhum objeto de dispositivo seja adicionado ou removido da pilha enquanto IoGetAttachedDevice está em execução. Os chamadores que não podem fazer isso devem usar IoGetAttachedDeviceReference .

Requisitos

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

Confira também

IoGetAttachedDeviceReference

ObDereferenceObject