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

Consulte também

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics