iPart::GetLocalId 方法 (devicetopology.h)

GetLocalId 方法获取此部件的本地 ID。

语法

HRESULT GetLocalId(
  [out] UINT *pnId
);

参数

[out] pnId

指向 UINT 变量的指针,方法在此变量中写入此部件的本地 ID。

返回值

如果该方法成功,则它会返回 S_OK。 如果失败,可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
E_POINTER
指针 pnIdNULL

注解

如果具有指向部件对象的指针,则可以调用此方法以获取部件的本地 ID。 本地 ID 是一个数字,用于唯一标识设备拓扑中所有部件中的部件。

IAudioInputSelector::GetSelectionIAudioOutputSelector::GetSelection 方法检索连接的部件的本地 ID。 IAudioInputSelector::SetSelectionIAudioOutputSelector::SetSelection 方法选择连接到由其本地 ID 标识的部件的输入或输出。 IDeviceTopology::GetPartById 方法获取由其本地 ID 标识的部件。

有关使用 GetLocalId 方法的代码示例,请参阅以下主题:

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 devicetopology.h

另请参阅

IAudioInputSelector::GetSelection

IAudioInputSelector::SetSelection

IAudioOutputSelector::GetSelection

IAudioOutputSelector::SetSelection

IDeviceTopology::GetPartById

IPart 接口