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 las características del dispositivo. Para obtener más información, consulte el miembro características de de la estructura DEVICE_OBJECT.
[in] OrInValues
Valor booleano. Si este valor es TRUE, el DeviceCharacteristics valor es ORed con características de dispositivo existentes. Si el valor es FALSE, el DeviceCharacteristics valor reemplaza las características existentes del dispositivo.
Valor devuelto
Ninguno
Observaciones
Para establecer las características del dispositivo, llame al método WdfDeviceInitSetCharacteristics en el EvtDriverDeviceAdd función de devolución de llamada 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, llame a WdfDeviceSetCharacteristics.
Para obtener más información sobre cómo llamar a WdfDeviceCreate, vea Creating a Framework Device Object.
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 disquete.
WdfDeviceInitSetCharacteristics(
DeviceInit,
FILE_FLOPPY_DISKETTE,
FALSE
);
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 | ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |