Funzione di callback PFNKSPIN (ks.h)
La routine di callback di un minidriver AVStream viene chiamata quando:
- Sono disponibili dati per l'elaborazione di una struttura KSPIN . Utilizzare questa routine per eseguire l'elaborazione basata su pin.
- 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. Restituisce STATUS_PENDING per interrompere l'elaborazione fino al successivo evento di attivazione.
Commenti
Informazioni su AVStrMiniPinProcess
Il minidriver specifica l'indirizzo di questa routine nel membro Process della relativa struttura KSPIN_DISPATCH .
Indicare che un filtro usa l'elaborazione basata su pin fornendo questa funzione dispatch. Il minidriver imposta i flag pin nella struttura KSPIN_DESCRIPTOR_EX pertinente che determina 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 perimetrale iniziale. A tale scopo, chiamare KsStreamPointerClone. Vedere Puntatori Stream 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 al flusso del 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_EX pertinente.
Questa routine è facoltativa.
Informazioni su AVStrMiniPinConnect
Il minidriver specifica l'indirizzo di questa routine nel membro Connect della relativa struttura KSPIN_DISPATCH .
Restituisce STATUS_SUCCESS o l'errore restituito dal tentativo di stabilire una connessione. Non restituire STATUS_PENDING.
Questa routine è facoltativa.
Vedere anche Pin KS.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile nei sistemi operativi Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ks.h (include Ks.h) |
| IRQL | (Vedere la sezione Osservazioni) |