función WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME (wdfiotarget.h)
[Se aplica a KMDF y UMDF]
La función WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inicializa la estructura WDF_IO_TARGET_OPEN_PARAMS de un controlador para que el controlador pueda abrir un destino de E/S especificando el nombre del dispositivo, el archivo o la interfaz del dispositivo. Si el nombre proporcionado no existe, el sistema no intentará crearlo.
Sintaxis
void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME(
[out] PWDF_IO_TARGET_OPEN_PARAMS Params,
[in] PCUNICODE_STRING TargetDeviceName,
[in] ACCESS_MASK DesiredAccess
);
Parámetros
[out] Params
Puntero a una estructura de WDF_IO_TARGET_OPEN_PARAMS asignada por el controlador, que inicializa la función.
[in] TargetDeviceName
Valor del miembro TargetDeviceName de la estructura WDF_IO_TARGET_OPEN_PARAMS .
[in] DesiredAccess
Valor del miembro DesiredAccess de la estructura WDF_IO_TARGET_OPEN_PARAMS .
Valor devuelto
None
Observaciones
Si TargetDeviceName especifica el nombre de un archivo que ya existe, el sistema abre el archivo existente. Si el archivo no existe, se produce un error en la operación de apertura.
La estructura WDF_IO_TARGET_OPEN_PARAMS se usa como entrada para el método WdfIoTargetOpen .
La función WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inicializa los miembros Size, Type, TargetDeviceName, DesiredAccess, CreateOptions y CreateDisposition de la estructura de WDF_IO_TARGET_OPEN_PARAMS especificada.
KMDF La función WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inicializa el miembro CreateDisposition en FILE_OPEN.
UMDF La función WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inicializa el miembro CreateDisposition en OPEN_EXISTING.
Para obtener más información sobre los destinos de E/S, consulte Uso de destinos de E/S.
Ejemplos
Para obtener un ejemplo de código que usa WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME, vea WdfIoTargetOpen.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfiotarget.h (incluya Wdf.h) |
| IRQL | Cualquier nivel |
Consulte también
WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME