Função KsStreamPointerClone (ks.h)
A funçãoKsStreamPointerClone cria um clone de um determinado ponteiro de fluxo.
Sintaxe
KSDDKAPI NTSTATUS KsStreamPointerClone(
[in] PKSSTREAM_POINTER StreamPointer,
[in, optional] PFNKSSTREAMPOINTER CancelCallback,
[in] ULONG ContextSize,
[out] PKSSTREAM_POINTER *CloneStreamPointer
);
Parâmetros
[in] StreamPointer
Um ponteiro para uma estrutura KSSTREAM_POINTER que representa o ponteiro de fluxo que deve ser clonado.
[in, optional] CancelCallback
Opcional. Um ponteiro para um minidriver fornecido rotina de AVStrMiniCancelCallback. O AVStream chamará essa rotina se o IRP associado ao CloneStreamPointer for cancelado.
[in] ContextSize
Esse parâmetro indica quantos bytes de informações de contexto do minidriver o ponteiro de fluxo de clone resultante deve ter. Se não zero, o número solicitado de bytes será alocado imediatamente após o ponteiro de fluxo retornado e o campo contexto de CloneStreamPointer aponta para a memória alocada.
[out] CloneStreamPointer
Um ponteiro para um ponteiro para uma estrutura KSSTREAM_POINTER. Após a conclusão bem-sucedida da operação de clonagem, cloneStreamPointer contém um ponteiro para o endereço do ponteiro de fluxo clonado.
Valor de retorno
KsStreamPointerClone retorna STATUS_SUCCESS, indicando que a operação de clonagem foi concluída normalmente ou um código de erro apropriado.
Observações
O clone resultante inicialmente refere-se ao mesmo quadro de dados que o ponteiro de fluxo original e está no mesmo estado (bloqueado ou desbloqueado). A adição de um ponteiro de fluxo de clone que faz referência a um quadro de dados incrementa a contagem de referência nesse quadro específico. Observe que o quadro em questão e, portanto, o IRP ao qual o quadro pertence, não é concluído até que a contagem de referência cai para zero.
Você pode usar o parâmetro ContextSize dessa chamada para minimizar as chamadas de alocação.
Consulte também de Ponteiros de Fluxo.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |