Windows Driver Kit: Windows Portable Devices
WPD Client Properties
Windows Portable Devices supports the following client properties.
| Property | VarType | Description |
| WPD_CLIENT_DESIRED_ACCESS | VT_UI4 | Indicates that the client requires unique access permissions (such as GENERIC_READ only). If this property is not set, WPD assumes GENERIC_READ | GENERIC_WRITE which is the recommended default. |
| WPD_CLIENT_MAJOR_VERSION | VT_UI4 | A number that specifies the major version of the client. |
| WPD_CLIENT_MINOR_VERSION | VT_UI4 | A number that specifies the minor version of the client. |
| WPD_CLIENT_NAME | VT_LPWSTR | A name string for the client application. |
| WPD_CLIENT_REVISION | VT_UI4 | A number that specifies the revision (or build number) of the client. |
| WPD_CLIENT_SECURITY_QUALITY_OF_SERVICE | VT_UI4 | Specifies the security quality of service for the connection to the driver. This relates to the Security Quality of Service flags for CreateFile.
For example, these flags allow or disallow a driver to impersonate the client. SECURITY_IDENTIFICATION is assumed if this value is not provided. Typically, applications should set this value to SECURITY_IMPERSONATION, since some drivers will require impersonation in order to function. However, applications running under strict security requirements with a known subset of devices may want to restrict the driver's ability to identify or impersonate the caller. Note that reducing the impersonation level to anything lower than SECURITY_IMPERSONATION may result in some drivers having reduced functionality. |
| WPD_CLIENT_SHARE_MODE | VT_UI4 | Specifies the share mode the client is requesting from the driver. The possible values are the same as for CreateFile (for example, FILE_SHARE_READ, FILE_SHARE_WRITE, and so on).
(FILE_SHARE_READ | FILE_SHARE_WRITE) is assumed if the client does not specify this parameter. This is the recommended default. However, in cases where a different share mode is required (for example, FILE_SHARE_READ to request read sharing only), this parameter is required. |
| WPD_CLIENT_WMDRM_APPLICATION_PRIVATE_KEY | VT_VECTOR_|VT_UI1 | Specifies the Windows Media DRM application private key of the client. |
| WPD_CLIENT_WMDRM_APPLICATION_CERTIFICATE | VT_VECTOR_|VT_UI1 | Specifies the Windows Media DRM certificate of the client. |
Requirements
Header: Defined in PortableDevice.h
See Also