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

Consulte también

IWDFIoRequest

ZwCreateFile