Метод IWDFIoTarget2::FormatRequestForSetInformation (wudfddi.h)

Статья
02/07/2025

[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]

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

Синтаксис

HRESULT FormatRequestForSetInformation(
  [in]           IWDFIoRequest              *pRequest,
  [in]           WDF_FILE_INFORMATION_CLASS InformationClass,
  [in, optional] IWDFFile                   *pFile,
  [in, optional] IWDFMemory                 *pInformationMemory,
  [in, optional] PWDFMEMORY_OFFSET          pInformationMemoryOffset
);

Параметры

[in] pRequest

Указатель на интерфейс IWDFIoRequest объекта запроса, представляющего запрос ввода-вывода.

[in] InformationClass

Значение WDF_FILE_INFORMATION_CLASSтипа, указывающее тип сведений, которые нужно задать.

[in, optional] pFile

Указатель на интерфейс IWDFFile объекта файла, связанного с запросом ввода-вывода. Этот параметр необходим для локальных и удаленных целевых объектов ввода-выводаи является необязательным (может быть null) для целевых объектов обработки ввода-вывода файлов.

[in, optional] pInformationMemory

Указатель на интерфейс IWDFMemory объекта памяти. Этот объект представляет входной буфер, содержащий предоставленные драйвером сведения о файле, указанные параметром InformationClass. Этот параметр является необязательным и может быть null.

[in, optional] pInformationMemoryOffset

Указатель на структуру WDFMEMORY_OFFSET, которая предоставляет необязательные значения смещения байтов и длины. Платформа использует эти значения для определения начального адреса и длины в входной буфере для передачи данных. Если этот указатель равен null, передача данных начинается в начале входного буфера, а размер передачи — это размер буфера.

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

FormatRequestForSetInformation возвращает S_OK, если операция выполнена успешно. В противном случае метод может вернуть следующее значение:

Возвращаемый код	Описание
E_OUTOFMEMORY	Платформа не смогла выделить память.

Этот метод может возвращать одно из других значений, содержащихся в Winerror.h.

Замечания

Используйте метод FormatRequestForSetInformation, а затем метод IWDFIoRequest::Send, чтобы отправлять запросы синхронно или асинхронно в целевой ввода-вывода.

Примеры

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

void
CMyQueue::OnDefaultIoHandler(
 IWDFIoQueue*  pQueue,
 IWDFIoRequest*  pRequest
    )
{
    HRESULT hr;
    IWDFDevice *pDevice;
    IWDFIoTarget *pTarget;
    IWDFFile *pFile;
    IWDFMemory *pInMemory;
    WDF_FILE_INFORMATION_CLASS infoClass;

    //
    // Obtain the device, default I/O target, and file object.
    //
    pQueue->GetDevice(&pDevice);
    pDevice->GetDefaultIoTarget(&pTarget);
    pRequest->GetFileObject(&pFile);

    if (WdfRequestQueryInformation==pRequest->GetType())
    {
        //
        // Declare an IWDFIoRequest2 interface pointer and obtain the
        // IWDFIoRequest2 interface from the IWDFIoRequest interface.
        //
        CComQIPtr<IWDFIoRequest2> r2 = pRequest;

        // 
        // Declare an IWDFIoTarget2 interface pointer and obtain the
        // IWDFIoTarget2 interface from the IWDFIoTarget interface.
        //
        CComQIPtr<IWDFIoTarget2> target2(pTarget);

        // 
        // Get the I/O request's input buffer.
        // 
        hr = pWdfRequest2->RetrieveInputMemory(&pInMemory);
        if (!SUCCEEDED(hr)) goto Error;

        // 
        // Get the I/O request's parameters.
        // 
        hr = pWdfRequest2->GetSetInformationParameters(&infoClass,
                                                       NULL);
        if (!SUCCEEDED(hr)) goto Error;

        //
        // Format a query information request and send it to the I/O target.
        //
        hr = target2->FormatRequestForSetInformation(pRequest,
                                                     infoClass,
                                                     pFile,
                                                     pInMemory,
                                                     NULL);
        if (!SUCCEEDED(hr)) goto Error;
        hr = pRequest->Send(pTarget,
                            WDF_REQUEST_SEND_OPTION_SYNCHRONOUS,
                            0);
    }
...
Error;
    //
    // Release objects.
    //
    SAFE_RELEASE(pDevice);
    SAFE_RELEASE(pTarget);
    SAFE_RELEASE(pFile);
    SAFE_RELEASE(pOutMemory);
}

Требования

Требование	Ценность
завершение поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа	Настольный
минимальная версия UMDF	1.9
заголовка	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

См. также

IWDFIoTarget2

IWDFIoTarget2::FormatRequestForQueryInformation

Поделиться через