Метод IMDServiceProvider2::CreateDevice (mswmdm.h)
Метод CreateDevice вызывается диспетчер устройств Windows Media для получения объектов IMDSPDevice, соответствующих каноническому устройству, полученному из подсистемы PnP. Этот метод должен быть реализован для поддержки PnP и Windows Обозреватель, но в противном случае он является необязательным. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.
Синтаксис
HRESULT CreateDevice(
[in] LPCWSTR pwszDevicePath,
[out] DWORD *pdwCount,
[out] IMDSPDevice ***pppDeviceArray
);
Параметры
[in] pwszDevicePath
Указатель на строку с расширенными символами, завершающуюся нулевым значением, содержащую путь к устройству, обнаруженное windows Media диспетчер устройств. Это имя получается из подсистемы PnP и является каноническим именем плюс "$ # ", где # — число с автоматическим приращением. Это имя можно передать непосредственно в такие функции, как CreateFile , для получения доступа к базовому объекту устройства ядра. Поставщик услуг должен создать объект-оболочку IMDSPDevice для этого устройства.
[out] pdwCount
Указатель на DWORD , содержащий количество создаваемых объектов IMDSPDevice .
[out] pppDeviceArray
Массив интерфейсов IMDSPDevice , представляющих устройства. Как правило, существует только один элемент массива, но поставщик услуг может создать несколько объектов IMDSPDevice , соответствующих имени пути устройства, если он создает объект IMDSPDevice для каждого хранилища верхнего уровня. Это значение может быть изменено в будущем, и число может быть ограничено 1.
Возвращаемое значение
Если метод выполнен успешно, он возвращает S_OK. Если метод завершается сбоем, он возвращает коды ошибок диспетчер устройств Windows Media.
Комментарии
Windows Media диспетчер устройств вызывает этот метод при запуске приложения или при подключении к компьютеру Plug and Play совместимого устройства.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | mswmdm.h |
| Библиотека | Mssachlp.lib |