función WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME (wdfiotarget.h)

  • Artículo

[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

WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE

WdfIoTargetOpen