Função IoGetAttachedDeviceReference (wdm.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 | Disponível a partir do Windows 2000. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include 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) |