Метод IPort::GetDeviceProperty (portcls.h)

Метод GetDeviceProperty предоставляет упрощенный доступ к свойствам устройства, содержащимся в реестре устройств Plug and Play.

Синтаксис

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

Параметры

DeviceProperty

Определяет конкретное свойство устройства, которое запрашивает вызывающий объект. Допустимые значения этого параметра совпадают с значениями, определенными для параметра DeviceProperty вызова IoGetDeviceProperty.

BufferLength

Указывает длину в байтах буфера, который требуется получить запрошенные сведения.

PropertyBuffer

Указатель на буфер свойств. Этот параметр указывает на выделенный вызывающим буфером, в который метод записывает запрошенные сведения о свойстве. Буфер должен быть достаточно большим, чтобы содержать количество байтов, указанных в BufferLength.

ResultLength

Указатель вывода на длину возвращаемых данных. Этот параметр указывает на переменную ULONG, выделенную вызывающим объектом, в которую метод записывает количество байтов, фактически записанных в буфер PropertyBuffer. Если буфер слишком мал, чтобы содержать сведения, метод вместо этого выводит требуемый размер буфера.

Возвращаемое значение

Этот метод возвращает NTSTATUS, содержащий STATUS_SUCCESS, если вызов выполнен успешно. В противном случае метод возвращает соответствующий код ошибки. Если буфер свойств, предоставленный вызывающим объектом, слишком мал, метод вернет STATUS_BUFFER_TOO_SMALL и выводит необходимый размер в ReturnLength.

Замечания

Этот метод извлекает свойства устройства аудиоадаптера. Она аналогична функции PcGetDeviceProperty, за исключением того, что она автоматически извлекает свойства устройства звукового адаптера, а не требует явного указания целевого устройства объекта устройства.

Требования

См. также

IPort