Função WdfWdmDeviceGetWdfDeviceHandle (wdfdevice.h)
[Aplica-se somente ao KMDF]
O método WdfWdmDeviceGetWdfDeviceHandle retorna um identificador para o objeto de dispositivo de estrutura associado a um objeto de dispositivo WDM especificado.
Sintaxe
WDFDEVICE WdfWdmDeviceGetWdfDeviceHandle(
[in] PDEVICE_OBJECT DeviceObject
);
Parâmetros
[in] DeviceObject
Um ponteiro para um WDM DEVICE_OBJECT estrutura que o driver de chamada criou.
Retornar valor
Se o objeto de dispositivo WDM especificado for válido, WdfWdmDeviceGetWdfDeviceHandle retornará um identificador para o objeto de dispositivo de estrutura associado. Caso contrário, o método retornará NULL.
Comentários
O WDM DEVICE_OBJECT estrutura que o driver especifica para o parâmetro DeviceObject deve representar um objeto de dispositivo que o driver de chamada criou. Por exemplo, a estrutura não pode representar nenhum dos objetos do dispositivo WDM especificados pelo driver em uma chamada anterior para WdfDeviceMiniportCreate.
Exemplos
O exemplo de código a seguir obtém um identificador para o objeto de dispositivo de estrutura associado a um objeto de dispositivo WDM que o driver de chamada criou.
WDFDEVICE device;
device = WdfWdmDeviceGetWdfDeviceHandle(pWdmDeviceObject);
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfdevice.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| Regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |