Interface IWDFDevice (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]
A interface IWDFDevice expõe um objeto de dispositivo, que é uma representação de um dispositivo no sistema.
Herança
A interface IWDFDevice herda de IWDFObject. IWDFDevice também tem esses tipos de membros:
- Métodos
Métodos
A interface IWDFDevice tem esses métodos.
| IWDFDevice::AssignDeviceInterfaceState O método AssignDeviceInterfaceState habilita ou desabilita a instância de interface do dispositivo especificada para um dispositivo. |
| IWDFDevice::CommitPnpState O método CommitPnpState confirma o estado da propriedade Plug and Play (PnP) (ou seja, ativa, desativa ou define como o estado padrão) que o método IWDFDevice::SetPnpState definiu. |
| IWDFDevice::ConfigureRequestDispatching O método ConfigureRequestDispatching configura a fila de solicitações de E/S do tipo especificado para a fila de E/S especificada. |
| IWDFDevice::CreateDeviceInterface O método CreateDeviceInterface cria uma instância de uma classe de interface do dispositivo. |
| IWDFDevice::CreateIoQueue O método CreateIoQueue configura a fila de E/S padrão associada a um dispositivo ou cria uma fila de E/S secundária para o dispositivo. |
| IWDFDevice::CreateRequest O método CreateRequest cria um objeto de solicitação não formatado. |
| IWDFDevice::CreateSymbolicLink O método CreateSymbolicLink cria um link simbólico para o dispositivo. |
| IWDFDevice::CreateWdfFile O método CreateWdfFile cria um objeto de arquivo para um driver usar. |
| IWDFDevice::GetDefaultIoQueue O método GetDefaultIoQueue recupera a interface da fila de E/S padrão para um dispositivo. |
| IWDFDevice::GetDefaultIoTarget O método GetDefaultIoTarget recupera a interface do destino de E/S padrão para uma instância de dispositivo. |
| IWDFDevice::GetDriver O método GetDriver recupera a interface para o objeto de driver pai de uma instância de dispositivo. |
| IWDFDevice::GetPnpState O método GetPnpState determina se a propriedade de Plug and Play (PnP) fornecida de um dispositivo está ativada ou desativada (ou definida como o estado padrão). |
| IWDFDevice::P ostEvent O método PostEvent notifica de forma assíncrona os aplicativos que estão aguardando o evento especificado de um driver. |
| IWDFDevice::RetrieveDeviceInstanceId O método RetrieveDeviceInstanceId recupera o identificador de uma instância de um dispositivo. |
| IWDFDevice::RetrieveDeviceName O método RetrieveDeviceName recupera o nome de um dispositivo no modo kernel subjacente. |
| IWDFDevice::RetrieveDevicePropertyStore O método RetrieveDevicePropertyStore recupera uma interface de repositório de propriedades. Os drivers podem usar o método para acessar o registro. |
| IWDFDevice::SetPnpState O método SetPnpState ativa ou desativa (ou define como o estado padrão) a propriedade de Plug and Play (PnP) especificada de um dispositivo. |
Comentários
Cada objeto de dispositivo tem um objeto de driver pai. Quando um novo dispositivo chega ao sistema, a estrutura chama a função de retorno de chamada IDriverEntry::OnDeviceAdd do driver para notificar o driver sobre a chegada. Em seguida, o driver pode chamar o método IWDFDriver::CreateDevice para receber um ponteiro para a interface IWDFDevice para o novo objeto de dispositivo.
Requisitos
| Requisito | Valor |
|---|---|
| Fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| Plataforma de Destino | Área de Trabalho |
| Versão mínima do UMDF | 1.5 |
| Cabeçalho | wudfddi.h (inclua Wudfddi.h) |