función WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE (wdfiotarget.h)

  • Artículo

[Solo se aplica a UMDF]

La función WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE inicializa la estructura de WDF_IO_TARGET_OPEN_PARAMS de un controlador para que el controlador pueda abrir un destino de E/S especificando un nombre de archivo.

Sintaxis

void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(
  [out]          PWDF_IO_TARGET_OPEN_PARAMS Params,
  [in, optional] PCUNICODE_STRING           FileName
);

Parámetros

[out] Params

Puntero a una estructura de WDF_IO_TARGET_OPEN_PARAMS asignada por el controlador, que inicializa la función.

[in, optional] FileName

Valor del miembro FileName de la estructura WDF_IO_TARGET_OPEN_PARAMS . La mayoría de los controladores especifican NULL aquí, a menos que el destino inferior admita el acceso al espacio de nombres de dispositivo.

Valor devuelto

None

Observaciones

La función WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE ceros la estructura de WDF_IO_TARGET_OPEN_PARAMS especificada y establece su miembro Size . También establece el miembro Type de la estructura en WdfIoTargetOpenLopenLocalTargetByFile y establece el miembro FileName si el controlador proporciona un nombre de archivo.

Un controlador puede cerrar explícitamente el destino de E/S llamando a WdfIoTargetClose. Si el controlador no cierra explícitamente el destino, el marco cierra el destino automáticamente cuando se quita el dispositivo (un destino de E/S está primario de forma predeterminada en el dispositivo).

Ejemplos

En el ejemplo de código siguiente se muestra cómo un controlador UMDF puede abrir un destino local con un objeto de archivo como se describe en WDF_IO_TARGET_OPEN_TYPE:

WDF_OBJECT_ATTRIBUTES  ioTargetAttrib;
WDFIOTARGET  ioTarget;
WDF_IO_TARGET_OPEN_PARAMS  openParams;

//
// Create target
//
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&ioTargetAttrib, TARGET_DEVICE_INFO);
status = WdfIoTargetCreate(device, &ioTargetAttrib, &ioTarget);
if (!NT_SUCCESS(status)) {
    return status;
}

//
// Open target
//
WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(&openParams, NULL);
status = WdfIoTargetOpen(ioTarget, &openParams);
if (!NT_SUCCESS(status)) {
    WdfObjectDelete(ioTarget);
    return status;
}

//
// create a request
//


//
// Format the request for the above target
//


//
// Send request to above target
//

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1
Plataforma de destino Universal
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_TYPE