Метод 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 |