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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 |
| Zielplattform | Universell |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfiotarget.h (einschließen von Wdf.h) |
| IRQL | Beliebige Ebene |