Función WdfDriverWdmGetDriverObject (wdfdriver.h)
[Solo se aplica a KMDF]
El método WdfDriverWdmGetDriverObject recupera un puntero al objeto de controlador de Windows Driver Model (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 de no es válido.
Observaciones
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 un función EvtCleanupCallback para el objeto del controlador de marco, el puntero es válido hasta que la función de devolución de llamada devuelve.
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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado | wdfdriver.h (incluya Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf) |