Função WdfDeviceWdmGetAttachedDevice (wdfdevice.h)
[Aplica-se somente ao KMDF]
O método WdfDeviceWdmGetAttachedDevice retorna o objeto de dispositivo WDM mais baixo na pilha do dispositivo .
Sintaxe
PDEVICE_OBJECT WdfDeviceWdmGetAttachedDevice(
[in] WDFDEVICE Device
);
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
Valor de retorno
WdfDeviceWdmGetAttachedDevice retorna um ponteiro para uma estrutura de DEVICE_OBJECT WDM. Se o identificador de objeto especificado representar um PDO (objeto de dispositivo físico), o método retornará NULL.
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
O ponteiro que o método WdfDeviceWdmGetAttachedDevice retorna é válido até que o objeto do dispositivo da estrutura seja excluído. Se o driver fornecer uma função EvtCleanupCallback para o objeto de dispositivo da estrutura, o ponteiro será válido até que a função de retorno de chamada retorne.
Exemplos
O exemplo de código a seguir cria uma mensagem de rastreamento que contém ponteiros para os objetos do dispositivo WDM que representam o PDO, o FDO e o dispositivo mais baixo de um dispositivo.
TraceEvents(
TRACE_LEVEL_INFORMATION,
DBG_PNP,
"PDO(0x%p) FDO(0x%p), Lower(0x%p)\n",
WdfDeviceWdmGetPhysicalDevice(device),
WdfDeviceWdmGetDeviceObject(device),
WdfDeviceWdmGetAttachedDevice(device)
);
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfdevice.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.) |
| IRQL | <= DISPATCH_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |