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