Obtendo informações do WDM

[Aplica-se apenas 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 WDM sobre o driver e seus dispositivos

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

WdfFdoInitWdmGetPhysicalDevice
Recupera a estrutura DEVICE_OBJECT que representa o objeto de dispositivo físico (DOP) 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 WDM DEVICE_OBJECT que representa o PDO de um dispositivo. Um driver pode chamar esse método depois de ter criado 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
Devolve o próximo objeto de dispositivo WDM inferior na pilha de dispositivos .

WdfWdmDeviceGetWdfDeviceHandle
Devolve um identificador para o objeto de dispositivo de framework que está associado a um objeto de dispositivo WDM especificado.

WdfWdmDriverGetWdfDriverHandle
Retorna um identificador para o objeto de driver do framework que está associado a um objeto de driver WDM especificado.

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

Para obter informações 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 pedido de framework especificado. (Por outro lado, um driver que recebe um WDM IRP fora do framework pode criar um objeto de pedido de framework 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 da solicitação do WDM.

WdfRequestRetrieveOutputWdmMdl
Recupera uma lista de descritores de memória (MDL) 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 da localização da pilha de E/S do driver chamador para a localização da pilha de E/S do alvo local de E/S do driver.

WdfRequestWdmFormatUsingStackLocation
Configura os conteúdos da localização da pilha de E/S para o alvo de E/S local do driver.

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

Para obter informações 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 WDM associada a um destino de E/S remoto.

WdfIoTargetWdmGetTargetFileHandle
Retorna um identificador para o ficheiro associado a um destino de entrada/saída remoto.

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

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

Para obter informações WDM sobre interrupções e chamadas de procedimento adiado (DPCs), 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 framework especificado.

WdfDpcWdmGetDpc
Retorna um ponteiro para a estrutura WDM KDPC que está associada a um objeto DPC de estrutura especificado.

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

Para obter informações WDM sobre destinos de entrada/saída 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 framework especificado.

Obtendo informações WDM sobre o Registro

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

WdfRegistryWdmGetHandle
Retorna um identificador WDM para a chave de registo que um objeto de chave de registo da estrutura de framework representa.

Obtendo informações do WDM sobre objetos de arquivo

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

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