Leer en inglés

Compartir a través de


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

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante 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 a UMDF.]

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

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 del modo kernel función de ZwCreateFile.

Los ocho bits altos de la variable indican las acciones que se deben realizar si el archivo no existe o aún 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 se puede 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 de la parámetro FileAttributes de ZwCreateFile.

Este parámetro es opcional y se puede 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 se puede 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 de DesiredAccess de ZwCreateFile.

Este parámetro es opcional y se puede NULL.

Valor devuelto

Ninguno

Observaciones

Una vez que el marco llama a la función de devolución de llamada IQueueCallbackCreate::OnCreateFile, 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 IQueueCallbackCreate::OnCreateFile función de devolución de llamada 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 Valor
fin del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
de la plataforma de destino de Escritorio
versión mínima de UMDF 1.9
encabezado de wudfddi.h (incluya Wudfddi.h)
DLL de WUDFx.dll

Consulte también

IQueueCallbackCreate::OnCreateFile

IWDFIoRequest2

IWDFIoRequest::GetCreateParameters