Función WdfDeviceInitSetCharacteristics (wdfdevice.h)
[Solo se aplica a KMDF]
El método WdfDeviceInitSetCharacteristics establece las características del dispositivo para un dispositivo especificado.
Sintaxis
void WdfDeviceInitSetCharacteristics(
[in] PWDFDEVICE_INIT DeviceInit,
[in] ULONG DeviceCharacteristics,
[in] BOOLEAN OrInValues
);
Parámetros
[in] DeviceInit
Puntero a una estructura de WDFDEVICE_INIT .
[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 .
[in] OrInValues
Valor booleano. Si este valor es TRUE, el valor DeviceCharacteristics es ORed con características de dispositivo existentes. Si el valor es FALSE, el valor DeviceCharacteristics reemplaza las características de dispositivo existentes.
Valor devuelto
None
Observaciones
Para establecer las características del dispositivo, llame 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 , llame a WdfDeviceSetCharacteristics.
Para obtener más información sobre cómo llamar a WdfDeviceCreate, vea Crear un objeto de dispositivo framework.
El marco siempre establece la característica FILE_DEVICE_SECURE_OPEN, por lo que el controlador no tiene que establecer esta característica.
Cada llamada a WdfDeviceInitSetCharacteristics sobrescribe la configuración de cualquier llamada anterior.
Ejemplos
En el ejemplo de código siguiente se indica que un dispositivo es un disco disquete.
WdfDeviceInitSetCharacteristics(
DeviceInit,
FILE_FLOPPY_DISKETTE,
FALSE
);
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 | ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |