CreateDeviceAccessInstance 函数 (deviceaccess.h)
创建用于访问设备的对象。 实例化对象实现 IDeviceIoControl 和 ICreateDeviceAccessAsync 接口。
FYI) (条件:
!defined(__deviceaccess_h__) [-AND-] ((NTDDI_VERSION >= NTDDI_WIN8)) [-AND-] defined(__cplusplus)
从标头声明。
HRESULT WINAPI
CreateDeviceAccessInstance(
_In_ LPCWSTR deviceInterfacePath,
_In_ DWORD desiredAccess,
_Outptr_ ICreateDeviceAccessAsync **createAsync
);
语法
HRESULT CreateDeviceAccessInstance(
[in] PCWSTR deviceInterfacePath,
[in] DWORD desiredAccess,
ICreateDeviceAccessAsync **createAsync
);
参数
[in] deviceInterfacePath
此实例应绑定到的设备的有效设备接口路径。
[in] desiredAccess
请求的对设备的访问级别,可以汇总为读、写、两者都不 (零) 。
最常用的值是 GENERIC_READ、 GENERIC_WRITE或两者 (GENERIC_READ | GENERIC_WRITE) 。 有关详细信息,请参阅 通用访问权限、 文件安全性和访问权限、 文件访问权限常量、 创建和打开文件以及 ACCESS_MASK。
createAsync
用于控制此实例绑定的异步接口。 有关详细信息,请参阅 ICreateDeviceAccessAsync。
返回值
S_OK 是否成功创建基础对象和异步操作;否则为相应的错误。 请注意,此函数不执行实际绑定。这在异步操作过程中发生。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | deviceaccess.h |
Library | Deviceaccess.lib |
DLL | Deviceaccess.dll |