Método IWDFIoRequest::GetCreateParameters (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 GetCreateParameters recupera los parámetros de solicitud para una solicitud de tipo de creación.
Sintaxis
void GetCreateParameters(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess
);
Parámetros
[out, optional] pOptions
Puntero a una variable que recibe una máscara de bits de marcas que especifican las opciones que se aplican al crear o abrir el archivo asociado a la solicitud y la acción que se realizará si el archivo ya existe.
Los 8 bits altos de este parámetro corresponden al parámetro CreateDisposition del modo kernel función de ZwCreateFile. Estos 8 bits especifican la acción que se va a realizar, en función de si el archivo ya existe. Tenga en cuenta que estos valores de disposición difieren de los valores que se usan en el parámetro dwCreationDisposition de la función CreateFile CreateFile.
Los 24 bits bajos de este parámetro corresponden al parámetro CreateOptions de ZwCreateFile.
Este parámetro es opcional. El controlador puede pasar NULL si el controlador no requiere la información.
[out, optional] pFileAttributes
Puntero a una variable que recibe una máscara de bits de marcas de atributo que se aplica al crear o abrir el archivo asociado a la solicitud. Los atributos especificados explícitamente solo se aplican cuando el archivo se crea, reemplaza o, en algunas situaciones, se sobrescribe. De forma predeterminada, se especifica la marca FILE_ATTRIBUTE_NORMAL única. Sin embargo, esta marca se puede invalidar por cualquier otra marca o por una combinación OR bit a bit de marcas compatibles. La máscara de bits de las marcas de atributo corresponde al parámetro FileAttributes de ZwCreateFile.
Este parámetro es opcional. El controlador puede pasar NULL si el controlador no requiere la información.
[out, optional] pShareAccess
Puntero a una variable que recibe una máscara de bits de marcas que especifican los derechos de acceso al recurso compartido solicitados para el archivo asociado a la solicitud. Si la máscara de bits recibida es cero, se solicita acceso exclusivo. Para obtener más información sobre el acceso compartido, vea la descripción del parámetro ShareAccess de ZwCreateFile.
Este parámetro es opcional. El controlador puede pasar NULL si el controlador no requiere la información.
Valor devuelto
Ninguno
Observaciones
Aunque el controlador puede especificar opcionalmente NULL para cada uno de los pOptions, pFileAttributesy parámetros de pShareAccess, el controlador debe especificar al menos un parámetrono NULL para GetCreateParameters para que se ejecute correctamente.
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.5 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |