Obtendo informações do WDM

[Aplica-se somente ao KMDF]

A estrutura fornece vários métodos de objeto que permitem que o driver obtenha informações definidas pelo WDM.

Obtendo informações do WDM sobre o driver e seus dispositivos

Para obter informações do WDM sobre um driver e seus dispositivos, o driver pode chamar os seguintes métodos:

WdfFdoInitWdmGetPhysicalDevice
Recupera a estrutura DEVICE_OBJECT que representa o PDO (objeto de dispositivo físico) de um dispositivo. Um driver pode chamar esse método antes que o driver tenha criado um objeto de dispositivo de estrutura para o dispositivo.

WdfDeviceWdmGetPhysicalDevice
Recupera a estrutura de DEVICE_OBJECT do WDM que representa o PDO de um dispositivo. Um driver pode chamar esse método depois de criar um objeto de dispositivo de estrutura para o dispositivo.

WdfDeviceWdmGetDeviceObject
Retorna o objeto de dispositivo WDM associado a um objeto de dispositivo de estrutura especificado.

WdfDeviceWdmGetAttachedDevice
Retorna o objeto de dispositivo WDM mais baixo na pilha do dispositivo.

WdfWdmDeviceGetWdfDeviceHandle
Retorna um identificador para o objeto de dispositivo de estrutura associado a um objeto de dispositivo WDM especificado.

WdfWdmDriverGetWdfDriverHandle
Retorna um identificador para o objeto de driver de estrutura associado a um objeto de driver WDM especificado.

Obtendo informações do WDM sobre solicitações de E/S

Para obter informações do WDM sobre solicitações de E/S, um driver pode chamar os seguintes métodos:

WdfRequestWdmGetIrp
Retorna a estrutura WDM IRP associada a um objeto de solicitação de estrutura especificado. (Por outro lado, um driver que recebe um WDM IRP fora da estrutura pode criar um objeto de solicitação de estrutura para o IRP chamando WdfRequestCreateFromIrp.)

WdfRequestGetParameters
Recupera os parâmetros associados a um objeto de solicitação de estrutura especificado. A maioria desses parâmetros vem do local da pilha de E/S do WDM da solicitação.)

WdfRequestRetrieveOutputWdmMdl
Recupera uma MDL (lista de descritores de memória) que representa o buffer de saída de uma solicitação de E/S.

WdfRequestRetrieveInputWdmMdl
Recupera um MDL que representa o buffer de entrada de uma solicitação de E/S.

WdfRequestFormatRequestUsingCurrentType
Copia o conteúdo do local da pilha de E/S do driver de chamada para o local da pilha de E/S do destino de E/S local do driver.

WdfRequestWdmFormatUsingStackLocation
Define o conteúdo do local da pilha de E/S para o destino de E/S local do driver.

Obtendo informações do WDM sobre destinos de E/S

Para obter informações do WDM sobre destinos de E/S, um driver pode chamar os seguintes métodos:

WdfIoTargetWdmGetTargetDeviceObject
Retorna um ponteiro para o objeto de dispositivo WDM associado a um destino de E/S local ou remoto.

WdfIoTargetWdmGetTargetFileObject
Retorna um ponteiro para a estrutura de FILE_OBJECT do WDM associada a um destino de E/S remoto.

WdfIoTargetWdmGetTargetFileHandle
Retorna um identificador para o arquivo associado a um destino de E/S remoto.

WdfIoTargetWdmGetTargetPhysicalDevice
Retorna um ponteiro para o PDO (objeto de dispositivo físico) do WDM que representa o dispositivo de um destino de E/S remoto.

Obtendo informações do WDM sobre interrupções e DPCs

Para obter informações do WDM sobre interrupções e DPCs (chamadas de procedimento adiadas), um driver pode chamar os seguintes métodos:

WdfInterruptWdmGetInterrupt
Retorna um ponteiro para a estrutura WDM KINTERRUPT associada a um objeto de interrupção de estrutura especificado.

WdfDpcWdmGetDpc
Retorna um ponteiro para a estrutura KDPC do WDM associada a um objeto DPC de estrutura especificado.

Obtendo informações do WDM sobre destinos de E/S USB

Para obter informações do WDM sobre destinos de E/S USB, um driver pode chamar o seguinte método:

WdfUsbTargetPipeWdmGetPipeHandle
Retorna o identificador do tipo USBD_PIPE_HANDLE associado a um objeto de pipe de estrutura especificado.

Obtendo informações do WDM sobre o Registro

Para obter informações do WDM sobre o registro, um driver pode chamar o seguinte método:

WdfRegistryWdmGetHandle
Retorna um identificador WDM para a chave do Registro que um objeto de chave de registro de estrutura representa.

Obtendo informações do WDM sobre objetos de arquivo

Para obter informações do WDM sobre objetos de arquivo, um driver pode chamar o seguinte método:

WdfFileObjectWdmGetFileObject
Retorna a estrutura de FILE_OBJECT do WDM associada a um objeto de arquivo de estrutura especificado.