Función WdfDeviceSetCharacteristics (wdfdevice.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfDeviceSetCharacteristics establece las características del dispositivo para un dispositivo especificado.

Sintaxis

void WdfDeviceSetCharacteristics(
  [in] WDFDEVICE Device,
  [in] ULONG     DeviceCharacteristics
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] DeviceCharacteristics

Valor que consta de constantes definidas por el sistema ORed que representan características del dispositivo. Para obtener más información, vea el miembro Características de la estructura DEVICE_OBJECT .

Valor devuelto

None

Observaciones

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Debe establecer las características del dispositivo llamando al método WdfDeviceInitSetCharacteristics en la función de devolución de llamada EvtDriverDeviceAdd antes de llamar a WdfDeviceCreate. Si el controlador no puede determinar las características de un dispositivo hasta después de que se devuelva la función de devolución de llamada EvtDriverDeviceAdd , el controlador normalmente debe llamar a WdfDeviceSetCharacteristics en su función de devolución de llamada EvtDevicePrepareHardware .

Cada llamada a WdfDeviceSetCharacteristics sobrescribe la configuración de cualquier llamada anterior.

Ejemplos

En el ejemplo de código siguiente se establece la característica FILE_REMOVABLE_MEDIA para un dispositivo especificado.

WdfDeviceSetCharacteristics(
                            Device,
                            FILE_REMOVABLE_MEDIA
                            );

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfdevice.h (incluya Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics