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 DeviceCharacteristics será ORed com características de dispositivo existentes. Se o valor for FALSE, o valor DeviceCharacteristics substituirá as características existentes do dispositivo.

Retornar valor

Nenhum

Comentários

Para definir as características do dispositivo, chame 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, chame WdfDeviceSetCharacteristics.

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

A estrutura sempre define a característica FILE_DEVICE_SECURE_OPEN, portanto, o driver não precisa 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

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	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Confira também

WdfDeviceSetCharacteristics