función WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE (wdfiotarget.h)
[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 |