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
|
備註
此方法的其他多載可讓您指定特定音訊裝置的識別碼,而不是使用系統的預設裝置。
另請參閱
- 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
|
備註
此方法的其他多載可讓您指定特定音訊裝置的識別碼,而不是使用系統的預設裝置。
另請參閱
- 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)