Obtención de información de WDM

[Solo se aplica a KMDF]

El marco proporciona varios métodos de objeto que permiten al controlador obtener información definida por WDM.

Obtener información de WDM sobre el controlador y sus dispositivos

Para obtener información de WDM sobre un controlador y sus dispositivos, el controlador puede llamar a los métodos siguientes:

WdfFdoInitWdmGetPhysicalDevice
Recupera la estructura DEVICE_OBJECT que representa el objeto de dispositivo físico (PDO) de un dispositivo. Un controlador puede llamar a este método antes de que el controlador haya creado un objeto de dispositivo de marco para el dispositivo.

WdfDeviceWdmGetPhysicalDevice
Recupera la estructura DEVICE_OBJECT WDM que representa el PDO de un dispositivo. Un controlador puede llamar a este método después de crear un objeto de dispositivo de marco para el dispositivo.

WdfDeviceWdmGetDeviceObject
Devuelve el objeto de dispositivo WDM asociado a un objeto de dispositivo de marco especificado.

WdfDeviceWdmGetAttachedDevice
Devuelve el siguiente objeto de dispositivo WDM inferior en la pila de dispositivos.

WdfWdmDeviceGetWdfDeviceHandle
Devuelve un identificador al objeto de dispositivo de marco asociado a un objeto de dispositivo WDM especificado.

WdfWdmDriverGetWdfDriverHandle
Devuelve un identificador al objeto del controlador de marco asociado a un objeto de controlador WDM especificado.

Obtener información de WDM sobre solicitudes de E/S

Para obtener información de WDM sobre las solicitudes de E/S, un controlador puede llamar a los métodos siguientes:

WdfRequestWdmGetIrp
Devuelve la estructura IRP de WDM asociada a un objeto de solicitud de marco especificado. (Por otro lado, un controlador que recibe un IRP de WDM fuera del marco puede crear un objeto de solicitud de marco para irP mediante una llamada a WdfRequestCreateFromIrp).

WdfRequestGetParameters
Recupera los parámetros asociados a un objeto de solicitud de marco especificado. La mayoría de estos parámetros proceden de la ubicación de pila de E /S de WDM de la solicitud).

WdfRequestRetrieveOutputWdmMdl
Recupera una lista de descriptores de memoria (MDL) que representa el búfer de salida de una solicitud de E/S.

WdfRequestRetrieveInputWdmMdl
Recupera una MDL que representa el búfer de entrada de una solicitud de E/S.

WdfRequestFormatRequestUsingCurrentType
Copia el contenido de la ubicación de pila de E/S del controlador de llamada en la ubicación de la pila de E/S del destino de E/S local del controlador.

WdfRequestWdmFormatUsingStackLocation
Establece el contenido de la ubicación de la pila de E/S para el destino de E/S local del controlador.

Obtención de información de WDM sobre destinos de E/S

Para obtener información de WDM sobre los destinos de E/S, un controlador puede llamar a los métodos siguientes:

WdfIoTargetWdmGetTargetDeviceObject
Devuelve un puntero al objeto de dispositivo WDM asociado a un destino de E/S local o remoto.

WdfIoTargetWdmGetTargetFileObject
Devuelve un puntero a la estructura FILE_OBJECT WDM asociada a un destino de E/S remoto.

WdfIoTargetWdmGetTargetFileHandle
Devuelve un identificador al archivo asociado a un destino de E/S remoto.

WdfIoTargetWdmGetTargetPhysicalDevice
Devuelve un puntero al objeto de dispositivo físico (PDO) de WDM que representa el dispositivo del destino de E/S remoto.

Obtener información de WDM sobre interrupciones y DPC

Para obtener información de WDM sobre interrupciones y llamadas a procedimientos diferidos (DPC), un controlador puede llamar a los métodos siguientes:

WdfInterruptWdmGetInterrupt
Devuelve un puntero a la estructura KINTERRUPT de WDM asociada a un objeto de interrupción de marco especificado.

WdfDpcWdmGetDpc
Devuelve un puntero a la estructura KDPC de WDM asociada a un objeto DPC de marco especificado.

Obtener información de WDM sobre destinos de E/S USB

Para obtener información de WDM sobre los destinos de E/S USB, un controlador puede llamar al método siguiente:

WdfUsbTargetPipeWdmGetPipeHandle
Devuelve el identificador con tipo USBD_PIPE_HANDLE asociado a un objeto de canalización de marco especificado.

Obtener información de WDM sobre el Registro

Para obtener información de WDM sobre el registro, un controlador puede llamar al método siguiente:

WdfRegistryWdmGetHandle
Devuelve un identificador WDM a la clave del Registro que representa un objeto de clave del Registro de marco.

Obtener información de WDM sobre objetos de archivo

Para obtener información de WDM sobre objetos de archivo, un controlador puede llamar al método siguiente:

WdfFileObjectWdmGetFileObject
Devuelve la estructura FILE_OBJECT WDM asociada a un objeto de archivo de marco especificado.