Función WdfDriverWdmGetDriverObject (wdfdriver.h)
[Solo se aplica a KMDF]
El método WdfDriverWdmGetDriverObject recupera un puntero al objeto del controlador modelo de controlador de Windows (WDM) asociado a un objeto de controlador de marco especificado.
Sintaxis
PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
[in] WDFDRIVER Driver
);
Parámetros
[in] Driver
Identificador del objeto de controlador del marco de trabajo del controlador que obtuvo el controlador de una llamada anterior a WdfDriverCreate o WdfGetDriver.
Valor devuelto
WdfDriverWdmGetDriverObject devuelve un puntero a una estructura de DRIVER_OBJECT . Se produce una comprobación de errores del sistema si el controlador no es válido.
Comentarios
El puntero que devuelve el método WdfDriverWdmGetDriverObject es válido hasta que se elimina el objeto del controlador de marco. Si el controlador proporciona una función EvtCleanupCallback para el objeto del controlador de marco, el puntero es válido hasta que se devuelve la función de devolución de llamada.
Ejemplos
En el ejemplo de código siguiente se obtiene un puntero al objeto de controlador WDM asociado a un objeto de controlador de marco especificado.
PDRIVER_OBJECT pDrvObj;
pDrvObj = WdfDriverWdmGetDriverObject(Driver);
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdfdriver.h (incluya Wdf.h) |
| Library | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| IRQL | <= DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | DriverCreate(kmdf) |