IWDFIoRequest::GetCreateParameters method

The GetCreateParameters method retrieves the request parameters for a create-type request.

Syntax


void GetCreateParameters(
  [out, optional]  ULONG *pOptions,
  [out, optional]  USHORT *pFileAttributes,
  [out, optional]  USHORT *pShareAccess
);

Parameters

pOptions [out, optional]

A pointer to a variable that receives a bitmask of flags that specify the options that are applied when creating or opening the file that is associated with the request and the action to be taken if the file already exists.

The high 8 bits of this parameter correspond to the CreateDisposition parameter of the kernel-mode ZwCreateFile function. These 8 bits specify the action to be taken, depending on whether the file already exists. Note that these disposition values differ from the values that are used in the dwCreationDisposition parameter of the Win32 CreateFile function.

The low 24 bits of this parameter correspond to the CreateOptions parameter of ZwCreateFile.

This parameter is optional. The driver can pass NULL if the driver does not require the information.

pFileAttributes [out, optional]

A pointer to a variable that receives a bitmask of attribute flags that is applied when creating or opening the file that is associated with the request. Explicitly specified attributes are applied only when the file is created, superseded, or, in some situations, overwritten. By default, the single FILE_ATTRIBUTE_NORMAL flag is specified. However, this flag can be overridden by any other flag or by a bitwise OR combination of compatible flags. The bitmask of attribute flags corresponds to the FileAttributes parameter of ZwCreateFile.

This parameter is optional. The driver can pass NULL if the driver does not require the information.

pShareAccess [out, optional]

A pointer to a variable that receives a bitmask of flags that specify the share access rights that are requested for the file that is associated with the request. If the received bitmask is zero, exclusive access is being requested. For more information about share access, see the description of the ShareAccess parameter of ZwCreateFile.

This parameter is optional. The driver can pass NULL if the driver does not require the information.

Return value

None

Remarks

Although the driver can optionally specify NULL for each of the pOptions, pFileAttributes, and pShareAccess parameters, the driver must specify at least one non-NULL parameter for GetCreateParameters to execute successfully.

Requirements

End of support

Unavailable in UMDF 2.0 and later.

Minimum UMDF version

1.5

Header

Wudfddi.h (include Wudfddi.h)

DLL

WUDFx.dll

See also

IWDFIoRequest
ZwCreateFile

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft