Функция WdfDeviceMiniportCreate (wdfminiport.h)

Статья
08/08/2023

[Относится только к KMDF]

Метод WdfDeviceMiniportCreate создает объект устройства платформы, который может использовать драйвер мини-порта.

Синтаксис

NTSTATUS WdfDeviceMiniportCreate(
  [in]           WDFDRIVER              Driver,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [in]           PDEVICE_OBJECT         DeviceObject,
  [in, optional] PDEVICE_OBJECT         AttachedDeviceObject,
  [in, optional] PDEVICE_OBJECT         Pdo,
  [out]          WDFDEVICE              *Device
);

Параметры

[in] Driver

Дескриптор объекта драйвера платформы драйвера, полученный при предыдущем вызове WdfDriverCreate.

[in, optional] Attributes

Указатель на структуру, выделенную вызывающим объектом WDF_OBJECT_ATTRIBUTES , содержащую атрибуты для нового объекта. Этот параметр является необязательным и может быть WDF_NO_OBJECT_ATTRIBUTES.

[in] DeviceObject

Указатель на структуру WDM DEVICE_OBJECT , представляющую объект функционального устройства (FDO) для драйвера мини-порта.

[in, optional] AttachedDeviceObject

Указатель на структуру WDM DEVICE_OBJECT, представляющую следующий объект устройства в стеке устройств.

[in, optional] Pdo

Указатель на структуру WDM DEVICE_OBJECT, представляющую объект физического устройства (PDO) для устройства.

[out] Device

Указатель на расположение, которое получает дескриптор нового объекта устройства платформы.

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

Если метод WdfDeviceMiniportCreate не обнаруживает ошибок, он возвращает STATUS_SUCCESS. К дополнительным возвращаемым значениям относятся:

Код возврата	Описание
STATUS_INSUFFICIENT_RESOURCES	Не удалось выделить объект устройства.

Список других возвращаемых значений, которые может возвращать WdfDeviceMiniportCreate , см. в разделе Ошибки создания объектов платформы.

Метод может возвращать другие значения NTSTATUS.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Если драйвер минипорта использует платформу, драйвер минипорта должен вызвать WdfDeviceMiniportCreate , когда драйвер порта сообщит ему о доступности устройства. Драйверы минипорта не вызывают WdfDeviceCreate.

Драйвер мини-порта может получать указатели DeviceObject, AttachedDeviceObject и PDO от драйвера порта. Например, драйвер мини-порта NDIS может получить эти указатели, вызвав NdisMGetDeviceProperty.

Следующие ограничения применяются к объектам устройств платформы, которые драйвер мини-порта получает путем вызова WdfDeviceMiniportCreate:

Устройство, которое представляет объект устройства, должно поддерживать Plug and Play.
Объект устройства не поддерживает какие-либо функции обратного вызова событий объекта устройства. Поэтому драйвер порта должен обрабатывать все операции Plug and Play (PnP) и управления питанием.
Дескриптор объекта устройства не может быть передан в WdfWmiProviderCreate, поэтому драйвер порта должен обеспечить необходимую поддержку инструментария управления Windows (WMI).
Дескриптор объекта устройства не может быть передан в WdfIoQueueCreate, поэтому платформа не поддерживает очереди ввода-вывода для драйверов минипорта.
Дескриптор объекта устройства не может быть передан в WdfInterruptCreate, поэтому платформа не поддерживает объекты прерываний для драйверов минипорта.
Дескриптор объекта устройства нельзя передать никаким общим методам объекта устройства платформы, кроме WdfDeviceGetIoTarget, WdfDeviceWdmGetDeviceObject, WdfDeviceWdmGetAttachedDevice и WdfDeviceWdmGetPhysicalDevice.
Дескриптор объекта устройства не может быть передан никаким методам FDO платформы , кроме WdfFdoQueryForInterface.
Дескриптор объекта устройства не может быть передан каким-либо методам PDO платформы или WdfChildListCreate, поэтому драйвер минипорта не может быть драйвером автобуса.
Драйвер должен в конечном итоге вызвать WdfObjectDelete , чтобы удалить объект устройства, создаваемый WdfDeviceMiniportCreate .

Объекты устройств платформы, созданные WdfDeviceMiniportCreate , можно использовать в качестве родительского объекта для любого последующего созданного объекта платформы.

Чтобы отправлять запросы ввода-вывода в целевые объекты ввода-вывода, драйвер мини-порта может передать дескриптор объекта устройства в WdfDeviceGetIoTarget, WdfIoTargetCreate или WdfUsbTargetDeviceCreateWithParameters.

Драйвер мини-порта может передать дескриптор объекта устройства в WdfDmaEnablerCreate , если устройство поддерживает операции DMA.

Дополнительные сведения о драйверах минипорта см. в статье Использование платформы Kernel-Mode Driver Framework с драйверами miniport.

Примеры

В следующем примере кода вызывается NdisMGetDeviceProperty для получения указателей DeviceObject, AttachedDeviceObject и PDO ; инициализирует контекстное пространство объекта устройства и создает объект мини-порта устройства.

WDF_OBJECT_ATTRIBUTES  ObjectAttributes;

NdisMGetDeviceProperty(
                       MiniportAdapterHandle,
                       &Adapter->Pdo,
                       &Adapter->Fdo,
                       &Adapter->NextDeviceObject,
                       NULL,
                       NULL
                       );
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
                                        &ObjectAttributes,
                                        WDF_DEVICE_INFO
                                        );
ntStatus = WdfDeviceMiniportCreate(
                                   WdfGetDriver(),
                                   &ObjectAttributes,
                                   Adapter->Fdo,
                                   Adapter->NextDeviceObject,
                                   Adapter->Pdo,
                                   &Adapter->WdfDevice
                                   );
if (!NT_SUCCESS (ntStatus)) {
    Status = NDIS_STATUS_FAILURE;
    break;
}

Требования

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

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

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE

WdfDeviceCreate

WdfDriverMiniportUnload

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