Метод 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, за исключением того, что она автоматически извлекает свойства устройства звукового адаптера, а не требует, чтобы объект устройства явно указал целевое устройство.

Требования

Требование Значение
Заголовок portcls.h
IRQL PASSIVE_LEVEL

См. также раздел

IPort