PFNAVCINTERSECTHANDLER-Rückruffunktion (avc.h)

  • Artikel

Der AV/C-Schnitthandler bestimmt, ob die Datenbereiche kompatibel sind. Dies ist eine benutzerdefinierte Funktion, die auf dem folgenden Prototyp basiert:

Syntax

typedef NTSTATUS ( *PFNAVCINTERSECTHANDLER)(
  _In_      PVOID        Context,
  _In_      ULONG        PinId,
  _In_      PKSDATARANGE CallerDataRange,
  _In_      PKSDATARANGE DescriptorDataRange,
  _In_      ULONG        DataBufferSize,
  _Out_opt_ PVOID        Data,
  _Out_     PULONG       ReportedDataSize
);

Parameter

[in] Context

Ein optionaler Wert, der vom Intersect-Handler erwartet wird. Dieser Wert wird entweder vom Untereinheitstreiber (wenn der Untereinheitstreiber den Intersect-Handler bereitstellt) oder vom unteren Treiber bereitgestellt, der den Intersect-Handler bereitstellt.

[in] PinId

Gibt den Offset (oder die ID) des Pins an, für den die Schnittmenge ausgeführt wird.

[in] DataRange

[in] MatchingDataRange

[in] DataBufferSize

Die Größe des Puffers, der vom Datenmember übergeben wird. Wenn dies nonzero ist, sollte der Überschneidende Handler versuchen, das Datenformat zurückzugeben, das sich aus einem übereinstimmenden Datenbereichspaar ergibt. Wenn dies 0 ist, sollte der Intersect-Handler die erforderliche Puffergröße in ReportedDataSize bereitstellen und STATUS_BUFFER_OVERFLOW zurückgeben.

[out, optional] Data

Ein optionaler Puffer zum Empfangen des Datenformats, das sich aus einem übereinstimmenden Datenbereichspaar ergibt. Dieser Member wird ignoriert, wenn DataBufferSize null ist.

[out] DataSize

Rückgabewert

Der Intersect-Handler sollte STATUS_SUCCESS zurückgeben, wenn die Datenbereiche kompatibel sind und genügend Pufferraum vorhanden ist, um das resultierende Format zurückzugeben.

Rückgabecode Beschreibung
STATUS_NO_MATCH Die Datenbereiche sind nicht kompatibel.
STATUS_INTERNAL_ERROR Es kam zu einem unerwarteten Formatgrößenkonflikt.
STATUS_BUFFER_OVERFLOW Der Intersect-Handler gibt die erforderliche Puffergröße über das ReportedDataSize-Element zurück.
STATUS_BUFFER_TOO_SMALL Der Überschneidende Handler wurde nicht mit einem Puffer bereitgestellt, der groß genug ist, um das resultierende Format zu halten. Der Intersect-Handler muss erneut aufgerufen werden, wobei dataBufferSize auf 0 festgelegt ist, um die erforderliche Puffergröße zu bestimmen.
STATUS_INSUFFICIENT_RESOURCES Fehler bei der internen Pufferzuweisung.

Hinweise

Der AV/C-Intersect-Handler ist benutzerdefinierter, basierend auf dem obigen Funktionsprototyp.

Der Handler wird in Verbindung mit dem AVC_FUNCTION_GET_PIN_DESCRIPTOR-Funktionscode verwendet. Der Zweck des Handlers besteht darin, identische Pindatenformate abzugleichen und sie an den Aufrufer zurückzugeben.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile avc.h (include Avc.h)

Weitere Informationen