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

ADD
Show:
© 2014 Microsoft