STATUS_BLOCK-Struktur (video.h)
Die STATUS_BLOCK-Struktur ist eine Unterstruktur innerhalb der VIDEO_REQUEST_PACKET-Struktur. Die HwVidStartIO-Funktion eines Miniporttreibers muss den status Block jedes VRP festlegen, den er abruft.
Syntax
typedef struct _STATUS_BLOCK {
union {
VP_STATUS Status;
PVOID Pointer;
};
ULONG_PTR Information;
} STATUS_BLOCK, *PSTATUS_BLOCK;
Member
Status
Gibt das Ergebnis des angeforderten Vorgangs an. Bei diesem Member kann es sich um einen der folgenden status Codes handeln:
ERROR_INSUFFICIENT_BUFFER
Entweder ist der VRP InputBuffer zu klein, um die zum Verarbeiten der angegebenen Anforderung erforderlichen Daten bereitzustellen, oder der OutputBuffer ist zu klein, um die angeforderten Daten zurückzugeben.
ERROR_INVALID_FUNCTION
Der Miniporttreiber verarbeitet diese Anforderung nicht.
ERROR_INVALID_PARAMETER
Ein Parameter im VRP ist ungültig.
ERROR_IO_PENDING
Ein Vorgang wurde noch nicht abgeschlossen.
ERROR_MORE_DATA
Der Treiber verfügt über zusätzliche Daten, die zurückgegeben werden müssen, hat aber bereits den angegebenen VRP OutputBuffer ausgefüllt.
ERROR_NOT_ENOUGH_MEMORY
Es ist nicht genügend Arbeitsspeicher vorhanden, um die Anforderung zu verarbeiten.
NO_ERROR
Der angeforderte Vorgang wurde ausgeführt und erfolgreich abgeschlossen.
Pointer
Sollte vom Miniporttreiber ignoriert werden. Dieses Element der Union ist vorhanden, um die Feldausrichtung über 32- und 64-Bit-Systeme hinweg zu gewährleisten.
Information
Stellt zusätzliche Informationen zum abgeschlossenen Vorgang bereit. Die Bedeutung des Werts variiert je nach VRP. Im Allgemeinen wird dieser Member verwendet, um die für den Eingabepuffer erforderliche Mindestgröße zurückzugeben, wenn der VRP Daten im InputBuffer übergibt. Alternativ dazu enthält sie die Anzahl der Übertragenen Bytes, wenn der angeforderte Vorgang Daten im VRP OutputBuffer zurückgibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | video.h (Video.h einschließen) |