createDeviceAccessInstance 函式 (deviceaccess.h)

建立用來存取裝置的物件。 具現化物件會實作 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_READ GENERIC_WRITE | ) 。 如需詳細資訊，請參閱 一般訪問許可權、 檔案安全性和訪問許可權、 檔案訪問許可權常數、 建立和開啟檔案，以及 ACCESS_MASK。

createAsync

用來控制這個實例之系結的異步介面。 如需詳細資訊，請參閱 ICreateDeviceAccessAsync。

傳回值

如果 成功建立基礎對象和異步操作，S_OK;否則為適當的錯誤。 請注意，此函式不會執行實際的系結。這是異步操作的一部分。

規格需求