Функция WdfDmaTransactionGetRequest (wdfdmatransaction.h)
[Применяется только к KMDF]
Метод WdfDmaTransactionGetRequest извлекает дескриптор объекта запроса платформы, связанный с указанной транзакцией DMA.
Синтаксис
WDFREQUEST WdfDmaTransactionGetRequest(
[in] WDFDMATRANSACTION DmaTransaction
);
Параметры
[in] DmaTransaction
Дескриптор объекта транзакции DMA, полученного драйвером при предыдущем вызове WdfDmaTransactionCreate.
Возвращаемое значение
WdfDmaTransactionGetRequest возвращает дескриптор объекту запроса платформы, связанному с транзакцией DMA, указанной параметром DmaTransaction .
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Комментарии
Драйвер может вызывать WdfDmaTransactionGetRequest только для транзакций DMA, созданных драйвером путем вызова WdfDmaTransactionInitializeUsingRequest. Если драйвер вызывает WdfDmaTransactionGetRequest для транзакции DMA, созданной путем вызова WdfDmaTransactionInitialize, WdfDDmaTransactionGetRequest возвращает значение NULL.
Дополнительные сведения о выполнении передачи DMA см. в разделе Завершение передачи DMA.
Примеры
В следующем примере кода получается дескриптор объекта запроса платформы, связанный с указанной транзакцией DMA.
WDFREQUEST request;
request = WdfDmaTransactionGetRequest(dmaTransaction);
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Верхняя часть | wdfdmatransaction.h (включая Wdf.h) |
| Библиотека | Wdf01000.sys (см. раздел Управление версиями библиотеки платформы). |
| IRQL | <=DISPATCH_LEVEL |
| Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |