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 |