WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE-Funktion (wdfiotarget.h)

[Gilt nur für UMDF]

Die WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE-Funktion initialisiert die WDF_IO_TARGET_OPEN_PARAMS Struktur eines Treibers, sodass der Treiber ein E/A-Ziel öffnen kann, indem er einen Dateinamen angibt.

Syntax

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

Parameter

[out] Params

Ein Zeiger auf eine vom Treiber zugewiesene WDF_IO_TARGET_OPEN_PARAMS-Struktur , die von der Funktion initialisiert wird.

[in, optional] FileName

Ein Wert für das FileName-Element der WDF_IO_TARGET_OPEN_PARAMS-Struktur . Die meisten Treiber geben hier NULL an, es sei denn, das untere Ziel unterstützt den Zugriff auf Gerätenamespaces.

Rückgabewert

Keine

Bemerkungen

Die WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE-Funktion nullt die angegebene WDF_IO_TARGET_OPEN_PARAMS-Struktur und legt ihr Size-Element fest. Außerdem wird das Type-Element der Struktur auf WdfIoTargetOpenLocalTargetByFile festgelegt und das FileName-Element festgelegt, wenn der Treiber einen Dateinamen angibt.

Ein Treiber kann das E/A-Ziel explizit schließen, indem er WdfIoTargetClose aufruft. Wenn der Treiber das Ziel nicht explizit schließt, schließt das Framework das Ziel automatisch, wenn das Gerät entfernt wird (ein E/A-Ziel ist standardmäßig dem Gerät übergeordnet).

Beispiele

Das folgende Codebeispiel zeigt, wie ein UMDF-Treiber ein lokales Ziel mit einem Dateiobjekt öffnen kann, wie in WDF_IO_TARGET_OPEN_TYPE beschrieben:

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
//

Anforderungen

Weitere Informationen

WDF_IO_TARGET_OPEN_PARAMS

WDF_IO_TARGET_OPEN_TYPE