Função WdfDeviceAssignProperty (wdfdevice.h)
[Aplica-se a KMDF e UMDF]
O método WdfDeviceAssignProperty modifica a configuração atual de uma propriedade do 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 de WDF_DEVICE_PROPERTY_DATA que identifica a propriedade do dispositivo a ser modificada.
[in] Type
Uma variável tipoDEVPROPTYPE que especifica o tipo dos dados armazenados em Data.
[in] Size
O tamanho, em bytes, do buffer apontado por Data.
[in, optional] Data
Um ponteiro para um buffer alocado pelo chamador que contém os dados da propriedade do dispositivo. Defina esse parâmetro para NULL para excluir a propriedade especificada.
Valor de retorno
Se a operação for bem-sucedida, WdfDeviceAssignProperty retornará STATUS_SUCCESS. Os valores de retorno adicionais incluem:
| Código de retorno | Descrição |
|---|---|
|
Um dos parâmetros está incorreto. |
O método pode retornar outros valores NTSTATUS .
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
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 do dispositivo unificado.
Requisitos
| Requisito | Valor |
|---|---|
| da 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 |