Função WdfDeviceInitSetCharacteristics (wdfdevice.h)

Artigo
02/07/2025

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

Valor de retorno

Nenhum

Observações

Para definir as 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é depois que a função de retorno de chamada EvtDriverDeviceAdd retornar, 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

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

Consulte também

WdfDeviceSetCharacteristics

Compartilhar via