CreateDeviceAccessInstance 函数 (deviceaccess.h)

创建用于访问设备的对象。 实例化对象实现 IDeviceIoControlICreateDeviceAccessAsync 接口。

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_READGENERIC_WRITE或两者 (GENERIC_READ | GENERIC_WRITE) 。 有关详细信息,请参阅 通用访问权限文件安全性和访问权限文件访问权限常量创建和打开文件以及 ACCESS_MASK

createAsync

用于控制此实例绑定的异步接口。 有关详细信息,请参阅 ICreateDeviceAccessAsync

返回值

S_OK 是否成功创建基础对象和异步操作;否则为相应的错误。 请注意,此函数不执行实际绑定。这在异步操作过程中发生。

要求

要求
目标平台 Windows
标头 deviceaccess.h
Library Deviceaccess.lib
DLL Deviceaccess.dll