MidiOutPort.FromIdAsync(String) 메서드

정의

네임스페이스:

Windows.Devices.Midi

지정된 디바이스에 대한 MidiOutPort 개체를 만듭니다.

public:
 static IAsyncOperation<IMidiOutPort ^> ^ FromIdAsync(Platform::String ^ deviceId);

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<IMidiOutPort> FromIdAsync(winrt::hstring const& deviceId);

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<IMidiOutPort> FromIdAsync(string deviceId);

function fromIdAsync(deviceId)

Public Shared Function FromIdAsync (deviceId As String) As IAsyncOperation(Of IMidiOutPort)

매개 변수

deviceId

String

Platform::String

winrt::hstring

Windows.Devices.Enumeration.DeviceInformation.FindAllAsync 시스템에서 디바이스를 열거하여 가져올 수 있는 디바이스 ID입니다.

반환

IAsyncOperation<IMidiOutPort>

비동기 작업입니다. 완료되면 IAsyncOperation.GetResults 는 MidiOutPort 개체를 반환합니다.

특성

RemoteAsyncAttribute

예제

// Opens the default MIDI output device.
private async Task<IMidiOutPort> OpenDefaultMidiOut()
{
    IMidiOutPort midiOut = null;

    string midiOutQueryString = MidiOutPort.GetDeviceSelector();
    DeviceInformationCollection midiOutDevices = await DeviceInformation.FindAllAsync(midiOutQueryString);
    int selectedMidiDevice = 0;

    if (0 == midiOutDevices.Count)
    {
        Debug.WriteLine("No Midi output devices");
        return null;
    }
    // If there are > 1 MIDI out devices, pick the first non-integrated one.
    else if (2 <= midiOutDevices.Count)
    {
        for (int midiDeviceIdx = 0; midiDeviceIdx < midiOutDevices.Count; midiDeviceIdx++)
        {
            if (false == MidiSynthesizer.IsSynthesizer(midiOutDevices[midiDeviceIdx]))
            {
                selectedMidiDevice = midiDeviceIdx;
                break;
            }
        }
    }

    midiOut = await MidiOutPort.FromIdAsync(midiOutDevices[selectedMidiDevice].Id);

    return midiOut;
}

// Opens the default MIDI output device.
winrt::Windows::Foundation::IAsyncOperation<IMidiOutPort> OpenDefaultMidiOut()
{
    IMidiOutPort midiOut{ nullptr };

    winrt::hstring midiOutQueryString{ MidiOutPort::GetDeviceSelector() };
    DeviceInformationCollection midiOutDevices{ co_await DeviceInformation::FindAllAsync(midiOutQueryString) };
    uint32_t selectedMidiDevice{ 0 };

    if (0 == midiOutDevices.Size())
    {
        // No Midi output devices.
        co_return midiOut;
    }
    // If there are > 1 MIDI out devices, pick the first non-integrated one.
    else if (2 <= midiOutDevices.Size())
    {
        for (uint32_t midiDeviceIdx = 0; midiDeviceIdx < midiOutDevices.Size(); midiDeviceIdx++)
        {
            if (false == MidiSynthesizer::IsSynthesizer(midiOutDevices.GetAt(midiDeviceIdx)))
            {
                selectedMidiDevice = midiDeviceIdx;
                break;
            }
        }
    }

    midiOut = co_await MidiOutPort::FromIdAsync(midiOutDevices.GetAt(selectedMidiDevice).Id());

    co_return midiOut;
}

설명

시스템에서 MidiOutPort 개체를 열거하려면 GetDeviceSelector 에서 제공하는 쿼리 문자열을 Windows.Devices.Enumeration.DeviceInformation.FindAllAsync에 전달합니다.

MidiInPort를 만들기 위해 제안된 시간은 모든 종류의 앱 활성화 또는 사용자 상호 작용에 있습니다. MidiInPort에 대한 함수 호출이 실패하거나 MidiInPort에서 받은 메시지가 유효하지 않은 경우 포트를 즉시 다시 만들려고 하지 마세요.