Функция WdfFdoInitWdmGetPhysicalDevice (wdffdo.h)

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

Метод WdfFdoInitWdmGetPhysicalDevice извлекает объект физического устройства WDM (PDO).

Синтаксис

PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
  [in] PWDFDEVICE_INIT DeviceInit
);

Параметры

[in] DeviceInit

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

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

Если операция выполнена успешно, метод возвращает указатель на структуру DEVICE_OBJECT . В противном случае метод возвращает значение NULL.

Комментарии

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

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

Примеры

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

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

Требования

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