KsStreamPointerGetIrp-Funktion (ks.h)

Die KsStreamPointerGetIrp-Funktion gibt den IRP zurück, der dem Frame zugeordnet ist, auf den der angegebene Datenstromzeiger verweist.

Syntax

KSDDKAPI PIRP KsStreamPointerGetIrp(
  [in]            PKSSTREAM_POINTER StreamPointer,
  [out, optional] PBOOLEAN          FirstFrameInIrp,
  [out, optional] PBOOLEAN          LastFrameInIrp
);

Parameter

[in] StreamPointer

Ein Zeiger auf die KSSTREAM_POINTER-Struktur , die auf den Frame verweist, für den der zugeordnete IRP zurückgegeben wird.

[out, optional] FirstFrameInIrp

Ein Zeiger auf einen vom Aufrufer bereitgestellten BOOLEAN-Wert, der bei der Rückgabe auf TRUE festgelegt ist, wenn der frame, auf den von StreamPointer verwiesen wird, der erste Frame im zurückgegebenen IRP ist, und FALSE , falls nicht. Wenn NULL, testt AVStream diese Bedingung nicht.

[out, optional] LastFrameInIrp

Ein Zeiger auf einen vom Aufrufer bereitgestellten BOOLEAN-Wert, der auf TRUE festgelegt ist, wenn der Frame, auf den der Datenstromzeiger verweist, der letzte Frame im zurückgegebenen IRP und FALSE ist, falls nicht. Wenn NULL, testt AVStream diese Bedingung nicht.

Rückgabewert

KsStreamPointerGetIrp gibt entweder einen Zeiger auf den IRP zurück, der dem Frame zugeordnet ist, auf den der angegebene Streamzeiger verweist, oder gibt NULL zurück. Der Rückgabewert NULL gibt an, dass der Streamzeiger nicht gesperrt ist.

Hinweise

KsStreamPointerGetIrp kann auch verwendet werden, um zu bestimmen, ob StreamPointer auf den ersten und/oder letzten Frame verweist, der im zurückgegebenen IRP enthalten ist.

StreamPointer muss gesperrt sein, damit KsStreamPointerGetIrp erfolgreich ausgeführt werden kann. Jeder Versuch, diese Funktion mit einem entsperrten Streamzeiger aufzurufen, führt zu einem NULL-Rückgabewert .

FirstFrameInIrp und/oder LastFrameInIrp müssen zur Aufrufzeit ungleich NULL sein, damit AVStream diese Werte ausfüllen kann.

Siehe auch Stream Zeiger.

Anforderungen

Weitere Informationen

KsStreamPointerGetMdl

KsStreamPointerLock