Função WdfDeviceSetCharacteristics (wdfdevice.h)
[Aplica-se somente ao KMDF]
O método WdfDeviceSetCharacteristics define as características do dispositivo para um dispositivo especificado.
Sintaxe
void WdfDeviceSetCharacteristics(
[in] WDFDEVICE Device,
[in] ULONG DeviceCharacteristics
);
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
[in] DeviceCharacteristics
Um valor que consiste em constantes definidas pelo sistema ORed que representam as características do dispositivo. Para obter mais informações, consulte o membro características do da estrutura de DEVICE_OBJECT.
Valor de retorno
Nenhum
Observações
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Você deve definir as características do dispositivo chamando o método WdfDeviceInitSetCharacteristics em sua função de retorno de chamada EvtDriverDeviceAdd antes de chamar WdfDeviceCreate. Se o driver não puder determinar as características de um dispositivo até que o EvtDriverDeviceAdd função de retorno de chamada retorne, o driver normalmente deve chamar WdfDeviceSetCharacteristics em seu EvtDevicePrepareHardware função de retorno de chamada.
Cada chamada para WdfDeviceSetCharacteristics substitui as configurações de qualquer chamada anterior.
Exemplos
O exemplo de código a seguir define a característica de FILE_REMOVABLE_MEDIA para um dispositivo especificado.
WdfDeviceSetCharacteristics(
Device,
FILE_REMOVABLE_MEDIA
);
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfdevice.h (inclua Wdf.h) |
| biblioteca | Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |