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 características do dispositivo. Para obter mais informações, consulte o membro Características da estrutura DEVICE_OBJECT .

Retornar valor

Nenhum

Comentários

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Você deve definir as características do dispositivo chamando o método WdfDeviceInitSetCharacteristics na 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 a função de retorno de chamada EvtDriverDeviceAdd retorne, o driver normalmente deve chamar WdfDeviceSetCharacteristics em sua função de retorno de chamada EvtDevicePrepareHardware .

Cada chamada para WdfDeviceSetCharacteristics substitui as configurações de qualquer chamada anterior.

Exemplos

O exemplo de código a seguir define a característica FILE_REMOVABLE_MEDIA para um dispositivo especificado.

WdfDeviceSetCharacteristics(
                            Device,
                            FILE_REMOVABLE_MEDIA
                            );

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Cabeçalho	wdfdevice.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL	<=DISPATCH_LEVEL
Regras de conformidade da DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics