Получение сведений WDM

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

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

Получение сведений о драйвере и устройствах WDM

Чтобы получить WDM-сведения о драйвере и его устройствах, драйвер может вызвать следующие методы:

WdfFdoInitWdmGetPhysicalDevice
Извлекает структуру DEVICE_OBJECT, представляющую физический объект устройства (PDO). Драйвер может вызвать этот метод до того, как драйвер создал объект устройства платформы для устройства.

WdfDeviceWdmGetPhysicalDevice
Извлекает структуру WDM DEVICE_OBJECT, представляющую PDO устройства. Драйвер может вызвать этот метод после создания драйвером платформенного объекта устройства для данного устройства.

WdfDeviceWdmGetDeviceObject
Возвращает объект устройства WDM, связанный с указанным объектом устройства платформы.

WdfDeviceWdmGetAttachedDevice
Возвращает нижестоящий объект устройства WDM в стеке устройств .

WdfWdmDeviceGetWdfDeviceHandle
Возвращает дескриптор объекта устройства фреймворка, связанного с указанным объектом устройства WDM.

WdfWdmDriverGetWdfDriverHandle
Возвращает дескриптор объекта драйвера фреймворка, связанный с указанным объектом драйвера WDM.

Получение сведений о запросах ввода-вывода WDM

Чтобы получить сведения о запросах ввода-вывода WDM, драйвер может вызвать следующие методы:

WdfRequestWdmGetIrp
Возвращает структуру WDM IRP, связанную с указанным объектом запроса платформы. (С другой стороны, драйвер, получающий WDM IRP за пределами платформы, может создать объект запроса платформы для IRP путем вызова WdfRequestCreateFromIrp.)

WdfRequestGetParameters
Извлекает параметры, связанные с указанным объектом запроса платформы. Большинство этих параметров исходят из расположения стека ввода-вывода WDM запроса .

WdfRequestRetrieveOutputWdmMdl
Извлекает список дескриптора памяти (MDL), представляющий выходной буфер запроса ввода-вывода.

WdfRequestRetrieveInputWdmMdl
Извлекает MDL-файл, представляющий входной буфер запроса ввода-вывода.

WdfRequestFormatRequestUsingCurrentType
Копирует содержимое расположения стека ввода-вывода вызывающего драйвера в расположение стека ввода-вывода локального объекта ввода-вывода драйвера.

WdfRequestWdmFormatUsingStackLocation
Задает содержимое расположения стека ввода-вывода для локального целевого объекта ввода-вывода драйвера.

Получение сведений о целевых объектах ввода-вывода WDM

Чтобы получить сведения о целевых объектах ввода-вывода WDM, драйвер может вызвать следующие методы:

WdfIoTargetWdmGetTargetDeviceObject
Возвращает указатель на объект устройства WDM, связанный с локальным или удаленным целевым объектом ввода-вывода.

WdfIoTargetWdmGetTargetFileObject
Возвращает указатель на структуру WDM FILE_OBJECT, связанную с удаленным целевым объектом ввода-вывода.

WdfIoTargetWdmGetTargetFileHandle
Возвращает дескриптор файла, связанного с удаленным целевым объектом ввода-вывода.

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

Получение сведений об прерываниях и ЦП WDM

Чтобы получить сведения о прерываниях и отложенных вызовах процедур (DPC), драйвер может вызвать следующие методы:

WdfInterruptWdmGetInterrupt
Возвращает указатель на структуру WDM KINTERRUPT, связанную с указанным объектом прерывания фреймворка.

WdfDpcWdmGetDpc
Возвращает указатель на структуру WDM KDPC, связанную с указанным объектом DPC платформы.

получение данных WDM о целевых объектах ввода-вывода USB

Чтобы получить сведения о целевых объектах WDM ввода-вывода по USB, драйвер может вызвать следующий метод.

WdfUsbTargetPipeWdmGetPipeHandle
Возвращает дескриптор типа USBD_PIPE_HANDLE, связанный с указанным объектом канала фреймворка.

Получение сведений о реестре WDM

Чтобы получить сведения о реестре WDM, драйвер может вызвать следующий метод:

WdfRegistryWdmGetHandle
Возвращает дескриптор WDM к ключу реестра, который представляет собой объект ключа реестра фреймворка.

Получение сведений об объектах файлов WDM

Чтобы получить сведения о файлах WDM, драйвер может вызвать следующий метод:

WdfFileObjectWdmGetFileObject
Возвращает структуру WDM FILE_OBJECT, связанную с указанным объектом файла платформы.