AudioGraph.CreateDeviceInputNodeAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
CreateDeviceInputNodeAsync(MediaCategory) |
创建 AudioDeviceInputNode,用于从默认音频输入设备(例如麦克风或音频卡)将音频数据输入到音频图中。 |
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties) |
创建 AudioDeviceInputNode,用于从默认音频输入设备(如麦克风或音频卡)将音频数据输入到音频图中。 |
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation) |
创建 AudioDeviceInputNode,用于从指定的音频输入设备(如麦克风或音频卡)将音频数据输入到音频图中。 |
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter) |
创建一个已启用空间音频的 AudioDeviceInputNode,用于从指定的音频输入设备(如麦克风或音频卡)将音频数据输入到音频图中。 |
CreateDeviceInputNodeAsync(MediaCategory)
创建 AudioDeviceInputNode,用于从默认音频输入设备(例如麦克风或音频卡)将音频数据输入到音频图中。
public:
virtual IAsyncOperation<CreateAudioDeviceInputNodeResult ^> ^ CreateDeviceInputNodeAsync(MediaCategory category) = CreateDeviceInputNodeAsync;
/// [Windows.Foundation.Metadata.Overload("CreateDeviceInputNodeAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory const& category);
[Windows.Foundation.Metadata.Overload("CreateDeviceInputNodeAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category);
function createDeviceInputNodeAsync(category)
Public Function CreateDeviceInputNodeAsync (category As MediaCategory) As IAsyncOperation(Of CreateAudioDeviceInputNodeResult)
参数
- category
- MediaCategory
MediaCategory 枚举值中的一个值,该值指示此节点处理的媒体的类别,使系统能够对媒体执行与内容相关的处理和优先顺序。
返回
完成时返回 CreateAudioDeviceInputNodeResult 的异步操作。 此对象公开一个 Status 属性,该属性指示操作成功或操作失败的原因。 DeviceInputNode 属性提供对成功时创建的输入节点的引用。
- 属性
Windows 要求
应用功能 |
backgroundMediaRecording
|
注解
此方法的其他重载允许指定特定音频设备的 ID,而不是使用系统的默认设备。
另请参阅
- CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)
- CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)
适用于
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)
创建 AudioDeviceInputNode,用于从默认音频输入设备(如麦克风或音频卡)将音频数据输入到音频图中。
public:
virtual IAsyncOperation<CreateAudioDeviceInputNodeResult ^> ^ CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties ^ encodingProperties) = CreateDeviceInputNodeAsync;
/// [Windows.Foundation.Metadata.Overload("CreateDeviceInputNodeWithFormatAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory const& category, AudioEncodingProperties const& encodingProperties);
[Windows.Foundation.Metadata.Overload("CreateDeviceInputNodeWithFormatAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties);
function createDeviceInputNodeAsync(category, encodingProperties)
Public Function CreateDeviceInputNodeAsync (category As MediaCategory, encodingProperties As AudioEncodingProperties) As IAsyncOperation(Of CreateAudioDeviceInputNodeResult)
参数
- category
- MediaCategory
MediaCategory 枚举值中的一个值,该值指示此节点处理的媒体的类别,使系统能够对媒体执行与内容相关的处理和优先顺序。
- encodingProperties
- AudioEncodingProperties
一个 对象,表示设备输入节点的音频编码属性,该节点指定创建节点将运行的采样率。 仅允许未压缩的 PCM 和 float 格式。
返回
完成时返回 CreateAudioDeviceInputNodeResult 的异步操作。 此对象公开一个 Status 属性,该属性指示操作成功或操作失败的原因。 DeviceInputNode 属性提供对成功时创建的输入节点的引用。
- 属性
Windows 要求
应用功能 |
backgroundMediaRecording
|
注解
此方法的其他重载允许指定特定音频设备的 ID,而不是使用系统的默认设备。
另请参阅
- CreateDeviceInputNodeAsync(MediaCategory)
- CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)
适用于
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)
创建 AudioDeviceInputNode,用于从指定的音频输入设备(如麦克风或音频卡)将音频数据输入到音频图中。
public:
virtual IAsyncOperation<CreateAudioDeviceInputNodeResult ^> ^ CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties ^ encodingProperties, DeviceInformation ^ device) = CreateDeviceInputNodeAsync;
/// [Windows.Foundation.Metadata.Overload("CreateDeviceInputNodeWithFormatOnDeviceAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory const& category, AudioEncodingProperties const& encodingProperties, DeviceInformation const& device);
[Windows.Foundation.Metadata.Overload("CreateDeviceInputNodeWithFormatOnDeviceAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties, DeviceInformation device);
function createDeviceInputNodeAsync(category, encodingProperties, device)
Public Function CreateDeviceInputNodeAsync (category As MediaCategory, encodingProperties As AudioEncodingProperties, device As DeviceInformation) As IAsyncOperation(Of CreateAudioDeviceInputNodeResult)
参数
- category
- MediaCategory
MediaCategory 枚举值中的一个值,该值指示此节点处理的媒体的类别,使系统能够对媒体执行与内容相关的处理和优先顺序。
- encodingProperties
- AudioEncodingProperties
一个 对象,表示设备输入节点的音频编码属性,该节点指定创建节点将运行的采样率。 仅允许未压缩的 PCM 和 float 格式。
- device
- DeviceInformation
一个 DeviceInformation 对象,表示设备输入节点将从中获取音频数据的设备。
返回
完成时返回 CreateAudioDeviceInputNodeResult 的异步操作。 此对象公开一个 Status 属性,该属性指示操作成功或操作失败的原因。 DeviceInputNode 属性提供对成功时创建的输入节点的引用。
- 属性
Windows 要求
应用功能 |
backgroundMediaRecording
|
注解
调用 FindAllAsync,传入 GetAudioCaptureSelector 返回的值,以获取表示可用捕获设备的 DeviceInformation 对象列表。 有关详细信息,请参阅 音频图。
另请参阅
- CreateDeviceInputNodeAsync(MediaCategory)
- CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)
适用于
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter)
创建一个已启用空间音频的 AudioDeviceInputNode,用于从指定的音频输入设备(如麦克风或音频卡)将音频数据输入到音频图中。
public:
virtual IAsyncOperation<CreateAudioDeviceInputNodeResult ^> ^ CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties ^ encodingProperties, DeviceInformation ^ device, AudioNodeEmitter ^ emitter) = CreateDeviceInputNodeAsync;
/// [Windows.Foundation.Metadata.Overload("CreateDeviceInputNodeWithFormatAndEmitterOnDeviceAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory const& category, AudioEncodingProperties const& encodingProperties, DeviceInformation const& device, AudioNodeEmitter const& emitter);
[Windows.Foundation.Metadata.Overload("CreateDeviceInputNodeWithFormatAndEmitterOnDeviceAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<CreateAudioDeviceInputNodeResult> CreateDeviceInputNodeAsync(MediaCategory category, AudioEncodingProperties encodingProperties, DeviceInformation device, AudioNodeEmitter emitter);
function createDeviceInputNodeAsync(category, encodingProperties, device, emitter)
Public Function CreateDeviceInputNodeAsync (category As MediaCategory, encodingProperties As AudioEncodingProperties, device As DeviceInformation, emitter As AudioNodeEmitter) As IAsyncOperation(Of CreateAudioDeviceInputNodeResult)
参数
- category
- MediaCategory
MediaCategory 枚举值中的一个值,该值指示此节点处理的媒体的类别,使系统能够对媒体执行与内容相关的处理和优先顺序。
- encodingProperties
- AudioEncodingProperties
一个 对象,表示设备输入节点的音频编码属性,该节点指定创建节点将运行的采样率。 仅允许未压缩的 PCM 和 float 格式。
- device
- DeviceInformation
一个 DeviceInformation 对象,表示设备输入节点将从中获取音频数据的设备。
- emitter
- AudioNodeEmitter
一个 对象,描述使用空间音频处理时从中发出节点音频的发射器的位置和其他物理特征。
返回
完成时返回 CreateAudioDeviceInputNodeResult 的异步操作。 此对象公开一个 Status 属性,该属性指示操作成功或操作失败的原因。 DeviceInputNode 属性提供对成功时创建的输入节点的引用。
- 属性
Windows 要求
设备系列 |
Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
|
API contract |
Windows.Foundation.UniversalApiContract (在 v3.0 中引入)
|
应用功能 |
backgroundMediaRecording
|
注解
调用 FindAllAsync,传入 GetAudioCaptureSelector 返回的值,以获取表示可用捕获设备的 DeviceInformation 对象列表。 有关详细信息,请参阅 音频图。
另请参阅
- CreateDeviceInputNodeAsync(MediaCategory)
- CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)
- CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)