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