Função WdfDeviceInitSetCharacteristics (wdfdevice.h)

[Aplica-se somente ao KMDF]

O método WdfDeviceInitSetCharacteristics define as características do dispositivo para um dispositivo especificado.

Sintaxe

void WdfDeviceInitSetCharacteristics(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] ULONG           DeviceCharacteristics,
  [in] BOOLEAN         OrInValues
);

Parâmetros

[in] DeviceInit

Um ponteiro para uma estrutura WDFDEVICE_INIT .

[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 .

[in] OrInValues

Um valor booliano. Se esse valor for TRUE, o valor de DeviceCharacteristics será ORed com características de dispositivo existentes. Se o valor for FALSE, o valor DeviceCharacteristics substituirá as características existentes do dispositivo.

Valor retornado

Nenhum

Comentários

Para definir características do dispositivo, chame 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 a função de retorno de chamada EvtDriverDeviceAdd retorne, chame WdfDeviceSetCharacteristics.

Para obter mais informações sobre como chamar WdfDeviceCreate, consulte Criando um objeto de dispositivo framework.

A estrutura sempre define a característica FILE_DEVICE_SECURE_OPEN, para que o driver não precise definir essa característica.

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

Exemplos

O exemplo de código a seguir indica que um dispositivo é um disquete.

WdfDeviceInitSetCharacteristics(
                                DeviceInit,
                                FILE_FLOPPY_DISKETTE,
                                FALSE
                                );

Requisitos

   
Plataforma de Destino Universal
Versão mínima do KMDF 1,0
Cabeçalho wdfdevice.h (include Wdf.h)
Biblioteca Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura).)
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Confira também

WdfDeviceSetCharacteristics