Método IWDFIoRequest2::GetCreateParametersEx (wudfddi.h)

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método GetCreateParametersEx recupera parámetros de creación de archivos asociados a un archivo que se está creando o abriendo.

Sintaxis

void GetCreateParametersEx(
  [out, optional] ULONG       *pOptions,
  [out, optional] USHORT      *pFileAttributes,
  [out, optional] USHORT      *pShareAccess,
  [out, optional] ACCESS_MASK *pDesiredAccess
);

Parámetros

[out, optional] pOptions

Puntero a una variable asignada por el autor de la llamada que recibe marcas de bits que indican las opciones de creación de archivos. Estas marcas de bits con nombre FILE_XXXX se definen en Wdm.h.

Los 24 bits bajos de la variable indican las opciones que se deben aplicar al crear o abrir el archivo. Para obtener más información sobre estos bits, vea la descripción del parámetro CreateOptions de la función ZwCreateFile en modo kernel.

Los ocho bits altos de la variable indican las acciones que se van a realizar si el archivo no existe o no existe. Para obtener más información sobre estos bits, vea la descripción del parámetro CreateDisposition de ZwCreateFile.

Este parámetro es opcional y puede ser NULL.

[out, optional] pFileAttributes

Puntero a una variable asignada por el autor de la llamada que recibe marcas de bits que indican atributos de archivo. Estas marcas de bits con nombre FILE_ATTRIBUTE_XXXX se definen en Wdm.h. Para obtener más información sobre estas marcas de bits, vea la descripción del parámetro FileAttributes de ZwCreateFile.

Este parámetro es opcional y puede ser NULL.

[out, optional] pShareAccess

Puntero a una variable asignada por el autor de la llamada que recibe marcas de bits que indican las opciones de uso compartido de archivos. Estas marcas de bits con nombre FILE_SHARE_XXXX se definen en Wdm.h. Para obtener más información sobre estas marcas de bits, vea la descripción del parámetro ShareAccess de ZwCreateFile.

Este parámetro es opcional y puede ser NULL.

[out, optional] pDesiredAccess

Puntero a una estructura de ACCESS_MASK asignada por el autor de la llamada que especifica el acceso solicitado al archivo. Para obtener más información sobre este parámetro, vea el parámetro DesiredAccess de ZwCreateFile.

Este parámetro es opcional y puede ser NULL.

Valor devuelto

None

Observaciones

Una vez que el marco llama a la función de devolución de llamada IQueueCallbackCreate::OnCreateFile de un controlador, el controlador puede llamar al método IWDFIoRequest::GetCreateParameters o al método IWDFIoRequest2::GetCreateParametersEx para obtener los parámetros de creación del archivo.

Para obtener más información, vea Obtener parámetros para solicitudes de E/S.

Ejemplos

En el ejemplo de código siguiente se muestra cómo una función de devolución de llamada IQueueCallbackCreate::OnCreateFile puede obtener la interfaz IWDFIoRequest2 y, a continuación, llamar a GetCreateParametersEx.

VOID
OnCreateFile(
    __in IWDFIoQueue* FxQueue,
    __in IWDFIoRequest* FxRequest,
    __in IWDFFile* FxFile
    )
{
    ULONG fileOptions;
    USHORT fileAttributes,
    USHORT shareAccess,
    ACCESS_MASK desiredAccess;
    ...
    CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
    fxRequest2->GetCreateParametersEx(&fileOptions
                                      &fileAttributes,
                                      &shareAccess,
                                      &desiredAccess);
    ...
}

Requisitos

Requisito Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1,9
Encabezado wudfddi.h (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IQueueCallbackCreate::OnCreateFile

IWDFIoRequest2

IWDFIoRequest::GetCreateParameters