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

이 instance 바인딩해야 하는 디바이스에 대한 유효한 디바이스 인터페이스 경로입니다.

[in] desiredAccess

디바이스에 대한 요청된 액세스 수준이며, 읽기, 쓰기, 둘 다 또는 둘 다(0)로 요약할 수 있습니다.

가장 일반적으로 사용되는 값은 GENERIC_READ, GENERIC_WRITE 또는 둘 다(GENERIC_READ GENERIC_WRITE | )입니다. 자세한 내용은 일반 액세스 권한, 파일 보안 및 액세스 권한, 파일 액세스 권한 상수, 파일 만들기 및 열기 및 ACCESS_MASK 참조하세요.

createAsync

이 instance 대한 바인딩을 제어하는 비동기 인터페이스입니다. 자세한 내용은 ICreateDeviceAccessAsync를 참조하세요.

반환 값

기본 개체 및 비동기 작업이 성공적으로 생성되었는지 S_OK. 그렇지 않으면 적절한 오류가 발생합니다. 이 함수는 실제 바인딩을 수행하지 않습니다. 비동기 작업의 일부로 발생합니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	deviceaccess.h
라이브러리	Deviceaccess.lib
DLL	Deviceaccess.dll