Функция WdfDmaTransactionGetRequest (wdfdmatransaction.h)

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

Метод WdfDmaTransactionGetRequest извлекает дескриптор объекта запроса платформы, связанного с указанной транзакцией DMA.

Синтаксис

WDFREQUEST WdfDmaTransactionGetRequest(
  [in] WDFDMATRANSACTION DmaTransaction
);

Параметры

[in] DmaTransaction

Дескриптор объекта транзакции DMA, полученный драйвером из предыдущего вызова WdfDmaTransactionCreate.

Возвращаемое значение

WdfDmaTransactionGetRequest возвращает дескриптор объекту запроса платформы, связанному с транзакцией DMA, указанной параметром DmaTransaction.

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Замечания

Драйвер может вызывать WdfDmaTransactionGetRequest только для транзакций DMA, созданных драйвером, вызвав WdfDmaTransactionInitializeUsingRequest. Если драйвер вызывает WdfDmaTransactionGetRequest для транзакции DMA, созданной путем вызова WdfDmaTransactionInitialize, WdfDmaTransactionGetReque st возвращает NULL.

Дополнительные сведения о завершении передачи DMA см. в разделе Завершение передачи DMA.

Примеры

Следующий пример кода получает дескриптор объекта запроса платформы, связанного с указанной транзакцией DMA.

WDFREQUEST  request;

request = WdfDmaTransactionGetRequest(dmaTransaction);

Требования

См. также

WdfDmaTransactionCreate

WdfDmaTransactionInitialize

WdfDmaTransactionInitializeUsingRequest