Поделиться через


Функция WdfDeviceInitSetDeviceType (wdfdevice.h)

[Применяется только к KMDF]

Метод WdfDeviceInitSetDeviceType задает тип устройства для указанного устройства.

Синтаксис

void WdfDeviceInitSetDeviceType(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] DEVICE_TYPE     DeviceType
);

Параметры

[in] DeviceInit

Указатель на структуру WDFDEVICE_INIT .

[in] DeviceType

Значение FILE_DEVICE_XXXX, определяющее тип устройства. Дополнительные сведения о FILE_DEVICE_XXXX значениях см. в разделе Указание типов устройств.

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

None

Remarks

Если драйвер вызывает WdfDeviceInitSetDeviceType, он должен сделать это перед вызовом WdfDeviceCreate.

Дополнительные сведения о вызове WdfDeviceCreate см. в разделе Создание объекта устройства платформы.

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

Если вы пишете драйвер UMDF, необходимо изменить INF-файл драйвера или внести изменения в реестр, чтобы указать тип устройства. Дополнительные сведения об использовании реестра см. в разделе Настройка свойств реестра объектов устройства во время установки.

Примеры

В следующем примере кода показано, что устройство является последовательным.

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfdevice.h (включая Wdf.h)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL <= DISPATCH_LEVEL
Правила соответствия DDI ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)