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 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 GetCreateParameters recupera los parámetros de solicitud para una solicitud de tipo create.
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 de la función ZwCreateFile en modo kernel. 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 de Win32.
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 de 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 a recursos compartidos 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
None
Observaciones
Aunque el controlador puede especificar opcionalmente NULL para cada uno de los parámetros pOptions, pFileAttributes y pShareAccess , el controlador debe especificar al menos un parámetro distinto de NULL para que GetCreateParameters se ejecute correctamente.
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.5 |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |
| Archivo DLL | WUDFx.dll |