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 las características del dispositivo. Para obtener más información, consulte el miembro características de de la estructura DEVICE_OBJECT.
Valor devuelto
Ninguno
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 del EvtDriverDeviceAdd función de devolución de llamada devuelve, el controlador normalmente debe llamar a WdfDeviceSetCharacteristics en su EvtDevicePrepareHardware función de devolución de llamada.
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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado de | wdfdevice.h (incluya Wdf.h) |
| biblioteca de | 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) |