AudioGraph.CreateDeviceInputNodeAsync AudioGraph.CreateDeviceInputNodeAsync AudioGraph.CreateDeviceInputNodeAsync AudioGraph.CreateDeviceInputNodeAsync AudioGraph.CreateDeviceInputNodeAsync Method

Definition

Overloads

CreateDeviceInputNodeAsync(MediaCategory) CreateDeviceInputNodeAsync(MediaCategory) CreateDeviceInputNodeAsync(MediaCategory) CreateDeviceInputNodeAsync(MediaCategory) CreateDeviceInputNodeAsync(MediaCategory)

Creates an AudioDeviceInputNode that inputs audio data into the audio graph from the default audio input device, such as a microphone or audio card.

CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)

Creates an AudioDeviceInputNode that inputs audio data into the audio graph from the default audio input device such as a microphone or audio card.

CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)

Creates an AudioDeviceInputNode that inputs audio data into the audio graph from the specified audio input device such as a microphone or audio card.

CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter)

Creates a spatial audio-enabled AudioDeviceInputNode that inputs audio data into the audio graph from the specified audio input device such as a microphone or audio card.

CreateDeviceInputNodeAsync(MediaCategory) CreateDeviceInputNodeAsync(MediaCategory) CreateDeviceInputNodeAsync(MediaCategory) CreateDeviceInputNodeAsync(MediaCategory) CreateDeviceInputNodeAsync(MediaCategory)

Creates an AudioDeviceInputNode that inputs audio data into the audio graph from the default audio input device, such as a microphone or audio card.

public : IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category)
IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category) const;
public IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category)
Public Function CreateDeviceInputNodeAsync(category As MediaCategory) As IAsyncOperation(Of CreateAudioDeviceInputNodeResult)
Windows.Media.Audio.AudioGraph.createDeviceInputNodeAsync(category).done( /* Your success and error handlers */ );

Parameters

category
MediaCategory MediaCategory MediaCategory

A value from the MediaCategory enumeration value indicating the category of the media processed by this node, allowing the system to perform content-appropriate processing and prioritization of the media.

Returns

An asynchronous operation that returns a CreateAudioDeviceInputNodeResult on completion. This object exposes a Status property, that indicates either that the operation was successful or the reason why the operation failed. The DeviceInputNode property provides a reference to the created input node on success.

Additional features and requirements

Capabilities
backgroundMediaRecording

Remarks

Other overloads of this method allow you to specify the ID of a specific audio device instead of using the system's default device.

See also

CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)

Creates an AudioDeviceInputNode that inputs audio data into the audio graph from the default audio input device such as a microphone or audio card.

public : IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties)
IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties) const;
public IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties)
Public Function CreateDeviceInputNodeAsync(category As MediaCategory, encodingProperties As AudioEncodingProperties) As IAsyncOperation(Of CreateAudioDeviceInputNodeResult)
Windows.Media.Audio.AudioGraph.createDeviceInputNodeAsync(category, encodingProperties).done( /* Your success and error handlers */ );

Parameters

category
MediaCategory MediaCategory MediaCategory

A value from the MediaCategory enumeration value indicating the category of the media processed by this node, allowing the system to perform content-appropriate processing and prioritization of the media.

encodingProperties
AudioEncodingProperties AudioEncodingProperties AudioEncodingProperties

An object representing the audio encoding properties for the device input node which specifies the sample rate at which the created node will operate. Only uncompressed PCM and float formats are allowed.

Returns

An asynchronous operation that returns a CreateAudioDeviceInputNodeResult on completion. This object exposes a Status property, that indicates either that the operation was successful or the reason why the operation failed. The DeviceInputNode property provides a reference to the created input node on success.

Additional features and requirements

Capabilities
backgroundMediaRecording

Remarks

Other overloads of this method allow you to specify the ID of a specific audio device instead of using the system's default device.

See also

CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)

Creates an AudioDeviceInputNode that inputs audio data into the audio graph from the specified audio input device such as a microphone or audio card.

public : IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties, DeviceInformation device)
IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties, DeviceInformation device) const;
public IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties, DeviceInformation device)
Public Function CreateDeviceInputNodeAsync(category As MediaCategory, encodingProperties As AudioEncodingProperties, device As DeviceInformation) As IAsyncOperation(Of CreateAudioDeviceInputNodeResult)
Windows.Media.Audio.AudioGraph.createDeviceInputNodeAsync(category, encodingProperties, device).done( /* Your success and error handlers */ );

Parameters

category
MediaCategory MediaCategory MediaCategory

A value from the MediaCategory enumeration value indicating the category of the media processed by this node, allowing the system to perform content-appropriate processing and prioritization of the media.

encodingProperties
AudioEncodingProperties AudioEncodingProperties AudioEncodingProperties

An object representing the audio encoding properties for the device input node which specifies the sample rate at which the created node will operate. Only uncompressed PCM and float formats are allowed.

device
DeviceInformation DeviceInformation DeviceInformation

A DeviceInformation object representing the device from which the device input node will get audio data.

Returns

An asynchronous operation that returns a CreateAudioDeviceInputNodeResult on completion. This object exposes a Status property, that indicates either that the operation was successful or the reason why the operation failed. The DeviceInputNode property provides a reference to the created input node on success.

Additional features and requirements

Capabilities
backgroundMediaRecording

Remarks

Call FindAllAsync, passing in the value returned by GetAudioCaptureSelector, to get the list of DeviceInformation objects representing the available capture devices. For more information, see Audio graphs.

See also

CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter) CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter)

Creates a spatial audio-enabled AudioDeviceInputNode that inputs audio data into the audio graph from the specified audio input device such as a microphone or audio card.

public : IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties, DeviceInformation device, AudioNodeEmitter emitter)
IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties, DeviceInformation device, AudioNodeEmitter emitter) const;
public IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties, DeviceInformation device, AudioNodeEmitter emitter)
Public Function CreateDeviceInputNodeAsync(category As MediaCategory, encodingProperties As AudioEncodingProperties, device As DeviceInformation, emitter As AudioNodeEmitter) As IAsyncOperation(Of CreateAudioDeviceInputNodeResult)
Windows.Media.Audio.AudioGraph.createDeviceInputNodeAsync(category, encodingProperties, device, emitter).done( /* Your success and error handlers */ );

Parameters

category
MediaCategory MediaCategory MediaCategory

A value from the MediaCategory enumeration value indicating the category of the media processed by this node, allowing the system to perform content-appropriate processing and prioritization of the media.

encodingProperties
AudioEncodingProperties AudioEncodingProperties AudioEncodingProperties

An object representing the audio encoding properties for the device input node which specifies the sample rate at which the created node will operate. Only uncompressed PCM and float formats are allowed.

device
DeviceInformation DeviceInformation DeviceInformation

A DeviceInformation object representing the device from which the device input node will get audio data.

emitter
AudioNodeEmitter AudioNodeEmitter AudioNodeEmitter

An object that describes the position and other physical characteristics of the emitter from which the node's audio is emitted when spatial audio processing is used.

Returns

An asynchronous operation that returns a CreateAudioDeviceInputNodeResult on completion. This object exposes a Status property, that indicates either that the operation was successful or the reason why the operation failed. The DeviceInputNode property provides a reference to the created input node on success.

Additional features and requirements

Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)
Capabilities
backgroundMediaRecording

Remarks

Call FindAllAsync, passing in the value returned by GetAudioCaptureSelector, to get the list of DeviceInformation objects representing the available capture devices. For more information, see Audio graphs.

See also