функция WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE (wdfiotarget.h)

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

Функция WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE инициализирует структуру драйвера WDF_IO_TARGET_OPEN_PARAMS, чтобы драйвер смог открыть целевой объект ввода-вывода, указав имя файла.

Синтаксис

VOID WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(
  [out]          PWDF_IO_TARGET_OPEN_PARAMS Params,
  [in, optional] PCUNICODE_STRING           FileName
);

Параметры

[out] Params

Указатель на выделенную драйвером структуру WDF_IO_TARGET_OPEN_PARAMS, которая инициализирует функцию.

[in, optional] FileName

Значение элемента FileName структуры WDF_IO_TARGET_OPEN_PARAMS. Большинство драйверов указывают null здесь, если нижний целевой объект не поддерживает доступ к пространству имен устройств.

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

Нет

Замечания

Функция WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE ноль указанной структуры WDF_IO_TARGET_OPEN_PARAMS и задает член размера. Он также задает элемент типа структуры WdfIoTargetOpenLocenTargetByFile и задает элемент fileName, если драйвер предоставляет имя файла.

Драйвер может явно закрыть целевой объект ввода-вывода, вызвав WdfIoTargetClose. Если драйвер явно не закрывает целевой объект, платформа автоматически закрывает целевой объект при удалении устройства (целевой объект ввода-вывода по умолчанию родительский объект для устройства).

Примеры

В следующем примере кода показано, как драйвер UMDF может открыть локальный целевой объект с объектом файла, как описано в WDF_IO_TARGET_OPEN_TYPE:

WDF_OBJECT_ATTRIBUTES  ioTargetAttrib;
WDFIOTARGET  ioTarget;
WDF_IO_TARGET_OPEN_PARAMS  openParams;

//
// Create target
//
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&ioTargetAttrib, TARGET_DEVICE_INFO);
status = WdfIoTargetCreate(device, &ioTargetAttrib, &ioTarget);
if (!NT_SUCCESS(status)) {
    return status;
}

//
// Open target
//
WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(&openParams, NULL);
status = WdfIoTargetOpen(ioTarget, &openParams);
if (!NT_SUCCESS(status)) {
    WdfObjectDelete(ioTarget);
    return status;
}

//
// create a request
//


//
// Format the request for the above target
//


//
// Send request to above target
//

Требования

См. также

WDF_IO_TARGET_OPEN_PARAMS

WDF_IO_TARGET_OPEN_TYPE