Freigeben über


Framework-Objektmethoden

Jedes Frameworkobjekt exportiert eine Reihe von Methoden (Funktionen). Jede Methode dient einem von zwei Zwecken:

  • Es führt eine Aktion aus, die dem -Objekt zugeordnet ist.

    Die WdfIoQueueCreate-Methode erstellt beispielsweise eine E/A-Warteschlange für ein Gerät.

    Methoden, die eine Aktion ausführen, geben in der Regel einen NTSTATUS-Wert zurück.

  • Es ruft eine Eigenschaft ab, die dem -Objekt zugeordnet ist, oder ändert diese.

    Die WdfRequestGetInformation-Methode gibt beispielsweise Informationen zur Vervollständigung einer E/A-Anforderung zurück, status.

    Methoden, die eine Eigenschaft abrufen, geben in der Regel den Wert der Eigenschaft zurück, während Methoden, die eine Eigenschaft ändern, in der Regel keinen Wert zurückgeben.

Jede Objektmethode akzeptiert ein Objekthandle als Eingabe. Wenn ein Treiber ein ungültiges Objekthandle an eine Objektmethode übergibt, wird eine Systemfehlerprüfung durchgeführt.