Funzione di callback PFNKSPIN (ks.h)
Viene chiamata la routine di callback di un minidriver AVStream quando:
- Sono disponibili dati per un struttura di KSPIN da elaborare. Utilizzare questa routine per eseguire l'elaborazione Pin-Centric.
- Il KSPIN pertinente funge da pin sink ed è connesso a un pin di origine AVStream.
Sintassi
PFNKSPIN Pfnkspin;
NTSTATUS Pfnkspin(
[in] PKSPIN Pin
)
{...}
Parametri
[in] Pin
Puntatore al KSPIN con dati frame disponibili per l'elaborazione.
Valore restituito
Restituire STATUS_SUCCESS per continuare l'elaborazione. Restituire STATUS_PENDING per interrompere l'elaborazione fino all'evento di attivazione successivo.
Osservazioni
Informazioni su AVStrMiniPinProcess
Il minidriver specifica l'indirizzo di questa routine nel membro Process della relativa struttura di KSPIN_DISPATCH.
Indicare che un filtro usa Pin-Centric elaborazione fornendo questa funzione dispatch. Il minidriver imposta i flag pin nella struttura KSPIN_DESCRIPTOR_EX pertinente che determinano quando AVStream chiama AVStrMiniPinProcess. Se il minidriver non imposta alcun flag nel descrittore, il comportamento predefinito è che AVStream chiama AVStrMiniPinProcess quando arrivano nuovi dati in una coda precedentemente vuota. Per altre informazioni sull'elaborazione dei trigger di elaborazione, vedere Pin-Centric Processing .See Pin-Centric Processing for more details on processing triggers.
Dopo l'elaborazione, il minidriver può impedire il completamento del fotogramma clonando il puntatore del flusso del bordo iniziale. A tale scopo, chiamare KsStreamPointerClone. Vedere puntatori di flusso perimetrali iniziali e finali.
In alternativa, specificare un bordo finale distinto impostando KSPIN_FLAG_DISTINCT_TRAILING_EDGE su KSPIN_DESCRIPTOR_EX. Una terza opzione non consiste nell'avanzare del puntatore del flusso di bordo iniziale.
L'invio del processo viene eseguito nel runtime di integrazione predefinito = PASSIVE_LEVEL o eventualmente in DISPATCH_LEVEL se il minidriver ha specificato KSPIN_FLAG_DISPATCH_LEVEL_PROCESSING nel KSPIN_DESCRIPTOR_EXpertinente.
Questa routine è facoltativa.
Informazioni su AVStrMiniPinConnect
Il minidriver specifica l'indirizzo di questa routine nel membro Connect della relativa struttura di KSPIN_DISPATCH.
Restituisce STATUS_SUCCESS o l'errore restituito dal tentativo di stabilire una connessione interna. Non restituire STATUS_PENDING.
Questa routine è facoltativa.
Vedere anche KS Pins.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in DirectX 8.0 e versioni successive di DirectX. |
| piattaforma di destinazione | Desktop |
| intestazione | ks.h (include Ks.h) |
| IRQL | (Vedere la sezione Osservazioni) |
Vedere anche
Filter-Centric di elaborazione
Pin-Centric di elaborazione