estrutura WDF_DEVICE_PNP_CAPABILITIES (wdfdevice.h)
[Aplica-se a KMDF e UMDF]
A estrutura WDF_DEVICE_PNP_CAPABILITIES descreve os recursos de Plug and Play de um dispositivo.
Sintaxe
typedef struct _WDF_DEVICE_PNP_CAPABILITIES {
ULONG Size;
WDF_TRI_STATE LockSupported;
WDF_TRI_STATE EjectSupported;
WDF_TRI_STATE Removable;
WDF_TRI_STATE DockDevice;
WDF_TRI_STATE UniqueID;
WDF_TRI_STATE SilentInstall;
WDF_TRI_STATE SurpriseRemovalOK;
WDF_TRI_STATE HardwareDisabled;
WDF_TRI_STATE NoDisplayInUI;
ULONG Address;
ULONG UINumber;
} WDF_DEVICE_PNP_CAPABILITIES, *PWDF_DEVICE_PNP_CAPABILITIES;
Membros
Size
O tamanho, em bytes, dessa estrutura.
LockSupported
Um valor de tipo WDF_TRI_STATE que indica, se definido como WdfTrue, que o dispositivo pode ser bloqueado em seu slot para evitar a ejeção. (Essa funcionalidade desabilita a ejeção de um dispositivo de seu slot, não ejetando mídia de um dispositivo.) Para obter mais informações sobre valores do tipo WDF_TRI_STATE, consulte a seção Comentários a seguir.
EjectSupported
Um valor do tipo WDF_TRI_STATE que indica, se definido como WdfTrue, que o dispositivo pode ser ejetado de seu slot. (Essa funcionalidade permite ejetar um dispositivo de seu slot, não ejetar mídia de um dispositivo.)
Removable
Um valor de tipo WDF_TRI_STATE que indica, se definido como WdfTrue, que o dispositivo pode ser removido enquanto o sistema está em execução. Se Removable estiver definido como WdfTrue e SurpriseRemovalOK estiver definido como WdfFalse, os usuários deverão usar o programa Desativar ou Ejetar Hardware do sistema.
DockDevice
Um valor de tipo WDF_TRI_STATE que indica, se definido como WdfTrue, que o dispositivo é uma estação de encaixe.
UniqueID
Um valor de tipo WDF_TRI_STATE que indica, se definido como WdfTrue, que a ID da instância do dispositivo é exclusiva para todo o sistema. Se UniqueID estiver definido como WdfFalse, a ID da instância será exclusiva somente para o barramento do dispositivo. Para obter mais informações sobre IDs de instância, consulte Cadeias de caracteres de identificação do dispositivo.
SilentInstall
Um valor do tipo WDF_TRI_STATE que indica, se definido como WdfTrue, que Gerenciador de Dispositivos não deve exibir caixas de diálogo durante a instalação do dispositivo.
SurpriseRemovalOK
Um valor do tipo WDF_TRI_STATE que indica, se definido como WdfTrue (e se Removível também estiver definido como WdfTrue), que os usuários podem remover o dispositivo sem usar o programa Desativar ou Ejetar Hardware do sistema.
HardwareDisabled
Um valor de tipo WDF_TRI_STATE que indica, se definido como WdfTrue, que o dispositivo está desabilitado.
NoDisplayInUI
Um valor do tipo WDF_TRI_STATE que indica, se definido como WdfTrue, que Gerenciador de Dispositivos não deve exibir o dispositivo.
Address
Um endereço que indica onde o dispositivo está localizado em seu barramento.
A interpretação desse número é específica do barramento. Se o endereço for desconhecido ou o motorista do ônibus não der suporte a um endereço, o motorista do ônibus deixará o membro Address no valor padrão de 0xFFFFFFFF (-1).
A lista a seguir descreve as informações que determinados motoristas de ônibus armazenam no Membro do endereço para seus dispositivos filho:
| Barramento | Descrição |
|---|---|
| 1394 | Não fornece um endereço porque os endereços são voláteis. O padrão é 0xFFFFFFFF. |
| EISA | Número do slot (0-F). |
| IDE | Para um dispositivo IDE, o endereço contém a ID de destino e o LUN. Para um canal IDE, o endereço é zero ou um (0 = canal primário e 1 = canal secundário). |
| ISApnp | Não fornece um endereço. O padrão é 0xFFFFFFFF. |
| Pc Card (PCMCIA) | O número do soquete (normalmente 0x00 ou 0x40). |
| PCI | O número do dispositivo na palavra alta e o número da função na palavra baixa. |
| SCSI | A ID de destino. |
| USB | O número da porta. |
UINumber
Um número associado ao dispositivo e que pode ser exibido nas interfaces do usuário. Esse número normalmente é um número de slot percebido pelo usuário, como um número impresso ao lado do slot no quadro ou algum outro número que ajuda o usuário a localizar o dispositivo. Se UINumber for desconhecido ou se o fornecimento de um número não ajudar o usuário a identificar a localização do dispositivo, o driver definirá esse valor como -1.
Comentários
Vários membros usam o tipo WDF_TRI_STATE . Para esses membros, um valor de WdfTrue indica que o dispositivo dá suporte à funcionalidade e um valor de WdfFalse indica que não. Um valor de WdfUseDefault indica que a estrutura usará o valor que um driver menor na pilha forneceu. Por exemplo, se um driver de barramento especificar WdfTrue para LockSupported e o driver de função do dispositivo especificar WdfUseDefault, a estrutura armazenará WdfTrue para a funcionalidade.
A estrutura WDF_DEVICE_PNP_CAPABILITIES é usada como entrada para WdfDeviceSetPnpCapabilities.
Para inicializar uma estrutura de WDF_DEVICE_PNP_CAPABILITIES, um driver deve chamar WDF_DEVICE_PNP_CAPABILITIES_INIT.
Requisitos
| Requisito | Valor |
|---|---|
| Versão mínima do KMDF | 1.0 |
| Versão mínima do UMDF | 2,0 |
| Cabeçalho | wdfdevice.h (inclua Wdf.h) |