HidDevice.FromIdAsync(String, FileAccessMode) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
deviceId 매개 변수로 식별된 디바이스에 대한 핸들을 엽니다. access 형식은 accessMode 매개 변수에 의해 지정됩니다.
public:
static IAsyncOperation<HidDevice ^> ^ FromIdAsync(Platform::String ^ deviceId, FileAccessMode accessMode);/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<HidDevice> FromIdAsync(winrt::hstring const& deviceId, FileAccessMode const& accessMode);[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<HidDevice> FromIdAsync(string deviceId, FileAccessMode accessMode);function fromIdAsync(deviceId, accessMode)Public Shared Function FromIdAsync (deviceId As String, accessMode As FileAccessMode) As IAsyncOperation(Of HidDevice)매개 변수
- deviceId
-
String
Platform::String
winrt::hstring
HID 디바이스를 식별하는 DeviceInformation ID입니다.
- accessMode
- FileAccessMode
액세스 모드를 지정합니다. 지원되는 액세스 모드는 읽기 및 읽기Write입니다.
반환
HidDevice 개체입니다. HID 디바이스 기능이 없거나 올바르지 않으면 입니다 null.
- 특성
설명
이 메서드는 스토어 앱에서 처음 호출될 때 동의 프롬프트를 표시하기 위해 UI 스레드에서 호출되어야 합니다. 사용자가 동의를 부여한 후에는 모든 애플리케이션 스레드에서 메서드를 호출할 수 있습니다.
애플리케이션 매니페스트는 이 메서드를 호출하기 전에 HID 디바이스 기능을 선언해야 합니다. HID 디바이스 기능이 없거나 잘못 지정된 경우 반환된 값이 null 되며 예외가 throw되지 않습니다.
SendOutputReportAsync를 호출하려면 FileAccessMode.ReadWrite를 사용하여 디바이스를 열어야 합니다. 그렇지 않으면 예외로 System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005) 호출이 실패합니다. SendFeatureReportAsync, GetFeatureReportAsync 또는 GetInputReportAsync를 호출하려면 FileAccessMode.Read 또는FileAccessMode.ReadWrite를 사용하여 디바이스를 열어야 합니다.