Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CreateDeviceAccessInstance function

Creates the object that's used to access a device. The instantiated object implements the IDeviceIoControl and ICreateDeviceAccessAsync interfaces.

Conditions (FYI):



 !defined(__deviceaccess_h__) [-AND-]  ((NTDDI_VERSION >= NTDDI_WIN8)) [-AND-]  defined(__cplusplus)

Declaration from header.



 HRESULT WINAPI  
CreateDeviceAccessInstance(  
    _In_ LPCWSTR deviceInterfacePath,  
    _In_ DWORD desiredAccess,  
    _Outptr_ ICreateDeviceAccessAsync **createAsync  
    );

Syntax


HRESULT CreateDeviceAccessInstance(
  _In_ LPCWSTR                           deviceInterfacePath,
  _In_ DWORD                             desiredAccess,
       _Outptr_ ICreateDeviceAccessAsync **createAsync
);

Parameters

deviceInterfacePath [in]

A valid device interface path for the device that this instance should bind to.

desiredAccess [in]

The requested level of access to the device, which can be summarized as read, write, both, or neither (zero).

The most commonly used values are GENERIC_READ, GENERIC_WRITE, or both (GENERIC_READ | GENERIC_WRITE). For more information, see Generic Access Rights, File Security and Access Rights, File Access Rights Constants, Creating and Opening Files, and ACCESS_MASK.

createAsync

Asynchronous interface to control binding for this instance. For more information, see ICreateDeviceAccessAsync.

Return value

S_OK if the underlying object and asynchronous operation are created successfully; an appropriate error otherwise. Note that this function doesn't perform the actual binding.That happens as part of the asynchronous operation.

Requirements

Header

Deviceaccess.h

Library

Deviceaccess.lib

DLL

Deviceaccess.dll

 

 

Community Additions

Show:
© 2017 Microsoft