IPort::GetDeviceProperty 方法(portcls.h)

GetDeviceProperty 方法提供对即插即用设备注册表中包含的设备属性的简化访问。

语法

NTSTATUS GetDeviceProperty(
  DEVICE_REGISTRY_PROPERTY DeviceProperty,
  ULONG                    BufferLength,
  PVOID                    PropertyBuffer,
  PULONG                   ResultLength
);

参数

DeviceProperty

标识调用方请求的特定设备属性。 此参数的有效值与为 IoGetDeviceProperty 调用的 DeviceProperty 参数定义的值相同。

BufferLength

指定接收所请求信息的缓冲区的长度(以字节为单位)。

PropertyBuffer

指向属性缓冲区的指针。 此参数指向调用方分配的缓冲区,该方法将请求的属性信息写入其中。 缓冲区必须足够大,才能包含 BufferLength 中指定的字节数。

ResultLength

指向返回数据的长度的输出指针。 此参数指向调用方分配的 ULONG 变量,该方法在其中写入计数,指定实际写入 PropertyBuffer 缓冲区的字节数。 但是,如果缓冲区太小而无法包含信息,则该方法将输出所需的缓冲区大小。

返回值

此方法返回 NTSTATUS,如果调用成功,则返回包含STATUS_SUCCESS。 否则,该方法将返回适当的错误代码。 如果调用方提供的属性缓冲区太小,该方法将返回STATUS_BUFFER_TOO_SMALL并在 ReturnLength 中输出所需的大小。

言论

此方法检索音频适配器的设备属性。 它类似于 PcGetDeviceProperty 函数的作,只是它自动检索音频适配器的设备属性,而不是要求设备对象显式指定目标设备。

要求

要求 价值
标头 portcls.h
IRQL PASSIVE_LEVEL

另请参阅

IPort