Получение сведений 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
Возвращает указатель на объект физического устройства (PDO) WDM, представляющий устройство удаленного целевого объекта ввода-вывода.

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

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

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

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

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

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

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

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

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

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

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

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

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