Функция CreateDeviceAccessInstance (deviceaccess.h)

Статья
03/05/2024

Создает объект , используемый для доступа к устройству. Созданный экземпляр объекта реализует интерфейсы 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_READGENERIC_WRITE). Дополнительные сведения см. в разделах Общие права доступа, Безопасность файлов и права доступа, Константы прав доступа к файлам, Создание и открытие файлов и ACCESS_MASK.

createAsync

Асинхронный интерфейс для управления привязкой для этого экземпляра. Дополнительные сведения см. в разделе ICreateDeviceAccessAsync.

Возвращаемое значение

S_OK , если базовый объект и асинхронная операция успешно созданы; в противном случае — соответствующая ошибка. Обратите внимание, что эта функция не выполняет фактическую привязку. Это происходит в рамках асинхронной операции.

Требования

Требование	Значение
Целевая платформа	Windows
Header	deviceaccess.h
Библиотека	Deviceaccess.lib
DLL	Deviceaccess.dll

Поделиться через