Função WdfDeviceAssignProperty (wdfdevice.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O método WdfDeviceAssignProperty modifica a configuração atual de uma propriedade de dispositivo.

Sintaxe

NTSTATUS WdfDeviceAssignProperty(
  [in]           WDFDEVICE                 Device,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           DEVPROPTYPE               Type,
  [in]           ULONG                     Size,
  [in, optional] PVOID                     Data
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] DeviceProperty

Um ponteiro para uma estrutura WDF_DEVICE_PROPERTY_DATA que identifica a propriedade do dispositivo a ser modificada.

[in] Type

Uma variável do tipo DEVPROPTYPE que especifica o tipo dos dados armazenados em Dados.

[in] Size

O tamanho, em bytes, do buffer apontado por Dados.

[in, optional] Data

Um ponteiro para um buffer alocado pelo chamador que contém os dados da propriedade do dispositivo. Defina esse parâmetro como NULL para excluir a propriedade especificada.

Retornar valor

Se a operação for bem-sucedida, WdfDeviceAssignProperty retornará STATUS_SUCCESS. Os valores de retorno adicionais incluem:

Código de retorno Descrição
STATUS_INVALID_PARAMETER
 Um dos parâmetros está incorreto.
 

O método pode retornar outros valores NTSTATUS.

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

Comentários

Você pode usar WdfDeviceAssignProperty para modificar a configuração de qualquer propriedade exposta por meio do modelo de propriedade unificada.

Para obter informações sobre métodos relacionados, consulte Acessando o modelo de propriedade de dispositivo unificado.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.13
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL APC_LEVEL

Confira também

WdfDeviceAssignInterfaceProperty