Fungsi CreateDeviceAccessInstance (deviceaccess.h)

Membuat objek yang digunakan untuk mengakses perangkat. Objek yang dibuat mengimplementasikan antarmuka IDeviceIoControl dan ICreateDeviceAccessAsync .

Kondisi (FYI):

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

Deklarasi dari header.

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

Sintaks

HRESULT CreateDeviceAccessInstance(
  [in] PCWSTR                   deviceInterfacePath,
  [in] DWORD                    desiredAccess,
       ICreateDeviceAccessAsync **createAsync
);

Parameter

[in] deviceInterfacePath

Jalur antarmuka perangkat yang valid untuk perangkat yang harus diikat instans ini.

[in] desiredAccess

Tingkat akses yang diminta ke perangkat, yang dapat diringkas sebagai baca, tulis, keduanya, atau tidak keduanya (nol).

Nilai yang paling umum digunakan adalah GENERIC_READ, GENERIC_WRITE, atau keduanya (GENERIC_WRITE GENERIC_READ | ). Untuk informasi selengkapnya, lihat Hak Akses Generik, Keamanan File dan Hak Akses, Konstanta Hak Akses File, Membuat dan Membuka File, dan ACCESS_MASK.

createAsync

Antarmuka asinkron untuk mengontrol pengikatan untuk instans ini. Untuk informasi selengkapnya, lihat ICreateDeviceAccessAsync.

Nilai kembali

S_OK jika objek yang mendasar dan operasi asinkron berhasil dibuat; kesalahan yang sesuai jika tidak. Perhatikan bahwa fungsi ini tidak melakukan pengikatan aktual. Itu terjadi sebagai bagian dari operasi asinkron.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	deviceaccess.h
Pustaka	Deviceaccess.lib
DLL	Deviceaccess.dll