Функция 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)