Función WdfDeviceSetCharacteristics (wdfdevice.h)
[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) |