windows-nt/Source/XPSP1/NT/drivers/wdm/capture/mini/1394dcam/ctrlpkt.c

928 lines
27 KiB
C
Raw Normal View History

2020-09-26 03:20:57 -05:00
//===========================================================================
//
// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
// KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR
// PURPOSE.
//
// Copyright (c) 1996 - 2000 Microsoft Corporation. All Rights Reserved.
//
//===========================================================================
/*++
Module Name:
CtrlPkt.c
Abstract:
Stream class based WDM driver for 1934 Desktop Camera.
This file contains code to handle the stream class control packets.
Author:
Yee J. Wu 24-Jun-98
Environment:
Kernel mode only
Revision History:
--*/
#include "strmini.h"
#include "ksmedia.h"
#include "1394.h"
#include "wdm.h" // for DbgBreakPoint() defined in dbg.h
#include "dbg.h"
#include "dcamdef.h"
#include "dcampkt.h"
#include "sonydcam.h"
#define WAIT_FOR_SLOW_DEVICE
#ifdef ALLOC_PRAGMA
#pragma alloc_text(PAGE, DCamSetKSStateSTOP)
#pragma alloc_text(PAGE, DCamSetKSStatePAUSE)
#pragma alloc_text(PAGE, DCamReceiveCtrlPacket)
#endif
NTSTATUS
DCamToStopStateCR(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP pIrp,
IN PDCAM_IO_CONTEXT pDCamIoContext
)
/*++
Routine Description:
This is the state machine to set the streaming state to STOP.
It start at PASSIVE_LEVEL and the lower driver may have raised it to DISPATCH_LEVEL.
Arguments:
DriverObject - Pointer to driver object created by system.
pIrp - Irp that just completed
pDCamIoContext - A structure that contain the context of this IO completion routine.
Return Value:
None.
--*/
{
PDCAM_EXTENSION pDevExt;
PSTREAMEX pStrmEx;
NTSTATUS Status;
PIRB pIrb;
PIO_STACK_LOCATION NextIrpStack;
if(!pDCamIoContext) {
return STATUS_MORE_PROCESSING_REQUIRED;
}
pIrb = pDCamIoContext->pIrb;
pDevExt = pDCamIoContext->pDevExt;
pStrmEx = (PSTREAMEX) pDevExt->pStrmEx;
DbgMsg2(("\'DCamToStopStateCR: completed DeviceState=%d; pIrp->IoStatus.Status=%x\n",
pDCamIoContext->DeviceState, pIrp->IoStatus.Status));
// Free MDL
if(pIrb->FunctionNumber == REQUEST_ASYNC_WRITE) {
DbgMsg3(("DCamToStopStateCR: IoFreeMdl\n"));
IoFreeMdl(pIrb->u.AsyncWrite.Mdl);
}
// Return error status and free resoruce.
if(pIrp->IoStatus.Status != STATUS_SUCCESS) {
if(pDCamIoContext->pSrb) {
ERROR_LOG(("DCamToStopStateCR: pIrp->IoStatus.Status %x; cancel all packets\n", pIrp->IoStatus.Status));
// In order to stop streaming, we must cancel all pending IRPs
// Cancel pending IRPS and complete SRB.
DCamCancelAllPackets(
pDCamIoContext->pSrb,
pDevExt,
&pDevExt->PendingReadCount
);
}
DCamFreeIrbIrpAndContext(pDCamIoContext, pDCamIoContext->pIrb, pIrp);
return STATUS_MORE_PROCESSING_REQUIRED;
}
switch (pDCamIoContext->DeviceState) {
case DCAM_STOPSTATE_SET_REQUEST_ISOCH_STOP:
//
// Now stop the stream at the device itself
//
// Next state:
pDCamIoContext->DeviceState = DCAM_STOPSTATE_SET_STOP_ISOCH_TRANSMISSION; // Keep track of device state that we just set.
pDCamIoContext->RegisterWorkArea.AsULONG = STOP_ISOCH_TRANSMISSION;
pIrb->FunctionNumber = REQUEST_ASYNC_WRITE;
pIrb->Flags = 0;
pIrb->u.AsyncWrite.DestinationAddress.IA_Destination_Offset.Off_High = INITIAL_REGISTER_SPACE_HI;
pIrb->u.AsyncWrite.DestinationAddress.IA_Destination_Offset.Off_Low =
pDevExt->BaseRegister + FIELDOFFSET(CAMERA_REGISTER_MAP, IsoEnable);
pIrb->u.AsyncWrite.nNumberOfBytesToWrite = sizeof(ULONG);
pIrb->u.AsyncWrite.nBlockSize = 0;
pIrb->u.AsyncWrite.fulFlags = 0;
InterlockedExchange(&pIrb->u.AsyncWrite.ulGeneration, pDevExt->CurrentGeneration);
pIrb->u.AsyncWrite.Mdl =
IoAllocateMdl(&pDCamIoContext->RegisterWorkArea, sizeof(ULONG), FALSE, FALSE, NULL);
MmBuildMdlForNonPagedPool(pIrb->u.AsyncWrite.Mdl);
// Set once and used again in the completion routine.
NextIrpStack = IoGetNextIrpStackLocation(pIrp);
NextIrpStack->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL;
NextIrpStack->Parameters.DeviceIoControl.IoControlCode = IOCTL_1394_CLASS;
NextIrpStack->Parameters.Others.Argument1 = pIrb;
IoSetCompletionRoutine(
pIrp,
DCamToStopStateCR,
pDCamIoContext,
TRUE,
TRUE,
TRUE
);
Status =
IoCallDriver(
pDevExt->BusDeviceObject,
pIrp
);
return STATUS_MORE_PROCESSING_REQUIRED;
case DCAM_STOPSTATE_SET_STOP_ISOCH_TRANSMISSION:
//
// Detach all buffers that might still be attached.
//
DbgMsg2(("\'DCamToStopStateCR: IsListEmpty()=%s; PendingRead=%d\n",
IsListEmpty(&pDevExt->IsochDescriptorList) ? "Yes" : "No", pDevExt->PendingReadCount));
if(pDCamIoContext->pSrb) {
//
// Cancel all pending and waiting buffers;
// and Complete DCamSetKSStateSTOP's SRB
//
DCamCancelAllPackets(
pDCamIoContext->pSrb,
pDevExt,
&pDevExt->PendingReadCount
);
// This pDCamIoContext->pSrb will be completed in DCamCancelPacket()
// But its Irb and Irp and context are freed here.
DCamFreeIrbIrpAndContext(pDCamIoContext, pDCamIoContext->pIrb, pIrp);
return STATUS_MORE_PROCESSING_REQUIRED;
} else {
ERROR_LOG(("DCamToStopStateCR:CanNOT call DCamCancelPacket() with a null pSrb\n"));
}
break;
default:
ERROR_LOG(("\'DCamToStopStateCR: Unknown pDCamIoContext->DeviceState=%d\n", pDCamIoContext->DeviceState));
ASSERT(FALSE);
break;
}
if(pDCamIoContext->pSrb) {
pDCamIoContext->pSrb->Status = pIrp->IoStatus.Status == STATUS_SUCCESS ? STATUS_SUCCESS : STATUS_UNSUCCESSFUL;
COMPLETE_SRB(pDCamIoContext->pSrb)
}
DCamFreeIrbIrpAndContext(pDCamIoContext, pDCamIoContext->pIrb, pIrp);
return STATUS_MORE_PROCESSING_REQUIRED;
}
VOID
DCamSetKSStateSTOP(
IN PHW_STREAM_REQUEST_BLOCK pSrb
)
/*++
Routine Description:
Into STOP streaming state.
(1) Stop device from steaming (!ISO_ENABLE)
(2) Stop listening (controller)
(3) Detach pending read buffer and return with Cancel, and
start the waiting read to be put into the pengin read and then Cancel.
Arguments:
pSrb - Pointer to Stream request block
Return Value:
Nothing
--*/
{
PDCAM_EXTENSION pDevExt;
PSTREAMEX pStrmEx;
PIRB pIrb;
PIRP pIrp;
PDCAM_IO_CONTEXT pDCamIoContext;
PIO_STACK_LOCATION NextIrpStack;
NTSTATUS Status, StatusWait;
PAGED_CODE();
pDevExt = (PDCAM_EXTENSION) pSrb->HwDeviceExtension;
ASSERT(pDevExt);
pStrmEx = (PSTREAMEX) pDevExt->pStrmEx;
ASSERT(pStrmEx);
DbgMsg1(("\'DCamSetKSStateSTOP: Frame captured:%d\n", (DWORD) pStrmEx->FrameCaptured));
//
// After this, no more read will be accepted.
//
pStrmEx->KSState = KSSTATE_STOP;
//
// First stop the stream internally inside the PC's 1394
// stack
//
if(!pDevExt->hResource) {
pSrb->Status = STATUS_INSUFFICIENT_RESOURCES;
COMPLETE_SRB(pSrb)
return;
}
//
// Wait for last read to complete.
// After KState == KSSTATE_STOP, we will return all SRB_READ.
//
StatusWait = KeWaitForSingleObject( &pStrmEx->hMutex, Executive, KernelMode, FALSE, 0 );
KeReleaseMutex(&pStrmEx->hMutex, FALSE);
if(!DCamAllocateIrbIrpAndContext(&pDCamIoContext, &pIrb, &pIrp, pDevExt->BusDeviceObject->StackSize)) {
pSrb->Status = STATUS_INSUFFICIENT_RESOURCES;
COMPLETE_SRB(pSrb)
return;
}
pDCamIoContext->DeviceState = DCAM_STOPSTATE_SET_REQUEST_ISOCH_STOP;
pDCamIoContext->pSrb = pSrb; // To do StreamClassStreamNotification()
pDCamIoContext->pDevExt = pDevExt;
pIrb->FunctionNumber = REQUEST_ISOCH_STOP;
pIrb->Flags = 0;
pIrb->u.IsochStop.hResource = pDevExt->hResource;
pIrb->u.IsochStop.fulFlags = 0;
NextIrpStack = IoGetNextIrpStackLocation(pIrp);
NextIrpStack->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL;
NextIrpStack->Parameters.DeviceIoControl.IoControlCode = IOCTL_1394_CLASS;
NextIrpStack->Parameters.Others.Argument1 = pIrb;
IoSetCompletionRoutine(
pIrp,
DCamToStopStateCR,
pDCamIoContext,
TRUE,
TRUE,
TRUE
);
Status =
IoCallDriver(
pDevExt->BusDeviceObject,
pIrp
);
ASSERT(Status == STATUS_SUCCESS || Status == STATUS_PENDING);
return; // Do StreamClassStreamNotification() in IoCompletionRoutine
}
NTSTATUS
DCamToPauseStateCR(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP pIrp,
IN PDCAM_IO_CONTEXT pDCamIoContext
)
/*++
Routine Description:
This routine is for use with synchronous IRP processing.
All it does is signal an event, so the driver knows it
can continue.
Arguments:
DriverObject - Pointer to driver object created by system.
pIrp - Irp that just completed
pDCamIoContext - A structure that contain the context of this IO completion routine.
Return Value:
None.
--*/
{
PDCAM_EXTENSION pDevExt;
PSTREAMEX pStrmEx;
PIRB pIrb;
if(!pDCamIoContext) {
return STATUS_MORE_PROCESSING_REQUIRED;
}
pIrb = pDCamIoContext->pIrb;
pDevExt = pDCamIoContext->pDevExt;
pStrmEx = (PSTREAMEX) pDevExt->pStrmEx;
ASSERT(pStrmEx);
DbgMsg2(("\'DCamToPauseStateCR: completed DeviceState=%d; pIrp->IoStatus.Status=%x\n",
pDCamIoContext->DeviceState, pIrp->IoStatus.Status));
// No reason it would failed.
ASSERT(pIrp->IoStatus.Status == STATUS_SUCCESS);
switch (pDCamIoContext->DeviceState) {
case DCAM_PAUSESTATE_SET_REQUEST_ISOCH_STOP:
break;
default:
ERROR_LOG(("DCamToPauseStateCompletionRoutine: Unknown or unexpected pDCamIoContext->DeviceState=%d\n", pDCamIoContext->DeviceState));
ASSERT(FALSE);
break;
}
//
// We are here only if switching from RUN->PAUSE,
// It is alreay set to PAUSE state in DCamSetKSStatePAUSE
//
if(pDCamIoContext->pSrb) {
pDCamIoContext->pSrb->Status = pIrp->IoStatus.Status == STATUS_SUCCESS ? STATUS_SUCCESS : STATUS_UNSUCCESSFUL;
COMPLETE_SRB(pDCamIoContext->pSrb)
}
DCamFreeIrbIrpAndContext(pDCamIoContext, pDCamIoContext->pIrb, pIrp);
return STATUS_MORE_PROCESSING_REQUIRED;
}
VOID
DCamSetKSStatePAUSE(
IN PHW_STREAM_REQUEST_BLOCK pSrb
)
/*++
Routine Description:
Set KSSTATE to KSSTATE_PAUSE.
Arguments:
Srb - Pointer to Stream request block
Return Value:
Nothing
--*/
{
PDCAM_EXTENSION pDevExt;
PSTREAMEX pStrmEx;
PIRB pIrb;
PIRP pIrp;
PDCAM_IO_CONTEXT pDCamIoContext;
PIO_STACK_LOCATION NextIrpStack;
NTSTATUS Status;
PAGED_CODE();
pDevExt = (PDCAM_EXTENSION) pSrb->HwDeviceExtension;
ASSERT(pDevExt);
pStrmEx = (PSTREAMEX) pDevExt->pStrmEx;
ASSERT(pStrmEx);
pSrb->Status = STATUS_SUCCESS;
switch(pStrmEx->KSState) {
case KSSTATE_ACQUIRE:
case KSSTATE_STOP:
//
// Out of STOP state,
// initialize frame and timestamp information.
// (Master's clock's stream time is also reset.)
//
pStrmEx->FrameCaptured = 0; // Actual count
pStrmEx->FrameInfo.DropCount = 0;
pStrmEx->FrameInfo.PictureNumber = 0;
pStrmEx->FrameInfo.dwFrameFlags = 0;
// Advanced one frame.
pStrmEx->FirstFrameTime = pStrmEx->pVideoInfoHeader->AvgTimePerFrame;
DbgMsg2(("\'DCamSetKSStatePAUSE: FirstFrameTime(%d)\n", pStrmEx->FirstFrameTime));
break;
case KSSTATE_RUN:
//
// Will ask controll to stop listening.
// All the pening buffer(s) are kept in the controller.
// Before it completely stop (some latency here),
// we might get some IsochCallback() with data.
//
if(!pDevExt->hResource) {
pSrb->Status = STATUS_INSUFFICIENT_RESOURCES;
break;
}
if(!DCamAllocateIrbIrpAndContext(&pDCamIoContext, &pIrb, &pIrp, pDevExt->BusDeviceObject->StackSize)) {
pSrb->Status = STATUS_INSUFFICIENT_RESOURCES;
break;
}
// Set to KSSTATE_PAUSE at the beginning to prvent CancelPacket being processed thinking
// it is still in KSSTATE_RUN state.
pStrmEx->KSState = KSSTATE_PAUSE;
pDCamIoContext->DeviceState = DCAM_PAUSESTATE_SET_REQUEST_ISOCH_STOP;
pDCamIoContext->pSrb = pSrb; // To do StreamClassStreamNotification()
pDCamIoContext->pDevExt = pDevExt;
pIrb->FunctionNumber = REQUEST_ISOCH_STOP;
pIrb->Flags = 0;
pIrb->u.IsochStop.hResource = pDevExt->hResource;
pIrb->u.IsochStop.fulFlags = 0;
NextIrpStack = IoGetNextIrpStackLocation(pIrp);
NextIrpStack->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL;
NextIrpStack->Parameters.DeviceIoControl.IoControlCode = IOCTL_1394_CLASS;
NextIrpStack->Parameters.Others.Argument1 = pIrb;
IoSetCompletionRoutine(
pIrp,
DCamToPauseStateCR,
pDCamIoContext,
TRUE,
TRUE,
TRUE
);
Status =\
IoCallDriver(
pDevExt->BusDeviceObject,
pIrp
);
return; // Do StreamClassStreamNotification() in IoCompletionRoutine
case KSSTATE_PAUSE:
ERROR_LOG(("DCamSetKSStatePAUSE: Already in KSSTATE_PAUSE state.\n"));
ASSERT(pStrmEx->KSState != KSSTATE_PAUSE);
break;
}
pStrmEx->KSState = KSSTATE_PAUSE;
COMPLETE_SRB(pSrb)
}
NTSTATUS
DCamToRunStateCR(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP pIrp,
IN PDCAM_IO_CONTEXT pDCamIoContext
)
/*++
Routine Description:
This routine is for use with synchronous IRP processing.
All it does is signal an event, so the driver knows it
can continue.
Arguments:
DriverObject - Pointer to driver object created by system.
pIrp - Irp that just completed
pDCamIoContext - A structure that contain the context of this IO completion routine.
Return Value:
None.
--*/
{
PDCAM_EXTENSION pDevExt;
PSTREAMEX pStrmEx;
NTSTATUS Status;
PIRB pIrb;
PIO_STACK_LOCATION NextIrpStack;
if(!pDCamIoContext) {
return STATUS_MORE_PROCESSING_REQUIRED;
}
pIrb = pDCamIoContext->pIrb;
pDevExt = pDCamIoContext->pDevExt;
DbgMsg2(("\'DCamToRunStateCR: completed DeviceState=%d; pIrp->IoStatus.Status=%x\n",
pDCamIoContext->DeviceState, pIrp->IoStatus.Status));
// Free MDL
if(pIrb->FunctionNumber == REQUEST_ASYNC_WRITE) {
DbgMsg3(("DCamToRunStateCR: IoFreeMdl\n"));
IoFreeMdl(pIrb->u.AsyncWrite.Mdl);
}
//
// CAUTION:
// STATUS_TIMEOUT can be a valid return that we may to try again.
// But should it be a HW issue that it is not responding to our write.
// Controller should have made many reties before return STATUS_TIMEOUT.
//
if(pIrp->IoStatus.Status != STATUS_SUCCESS) {
if(DCAM_RUNSTATE_SET_REQUEST_ISOCH_LISTEN != pDCamIoContext->DeviceState ||
STATUS_INSUFFICIENT_RESOURCES != pIrp->IoStatus.Status ) {
ERROR_LOG(("DCamToRunStateCR: pIrp->IoStatus.Status=%x; free resoruce and STOP\n", pIrp->IoStatus.Status));
if(pDCamIoContext->pSrb) {
pDCamIoContext->pSrb->Status = pIrp->IoStatus.Status == STATUS_SUCCESS ? STATUS_SUCCESS : STATUS_UNSUCCESSFUL;
COMPLETE_SRB(pDCamIoContext->pSrb);
}
DCamFreeIrbIrpAndContext(pDCamIoContext, pDCamIoContext->pIrb, pIrp);
return STATUS_MORE_PROCESSING_REQUIRED;
} else {
//
// This is OK:
// If we get an insufficient resources error that means
// we don't have any Reads down yet. Set flag to TRUE
// indicating that when we do get a Read down we'll
// actually need to begin the listening process.
//
pDevExt->bNeedToListen = TRUE;
DbgMsg1(("DCamToRunStateCR: ##### no read yet! set pDevExt->bNeedToListen = TRUE\n"));
}
}
#ifdef WAIT_FOR_SLOW_DEVICE
KeStallExecutionProcessor(5000); // 5 msec
#endif
switch (pDCamIoContext->DeviceState) {
case DCAM_RUNSTATE_SET_REQUEST_ISOCH_LISTEN:
//
// Bit[24..26]0:0000 = CurrentFrameRate
//
pDCamIoContext->RegisterWorkArea.AsULONG = pDevExt->FrameRate << 5;
DbgMsg2(("\'DCamToRunState: FrameRate %x\n", pDCamIoContext->RegisterWorkArea.AsULONG));
pIrb->FunctionNumber = REQUEST_ASYNC_WRITE;
pIrb->Flags = 0;
pIrb->u.AsyncWrite.DestinationAddress.IA_Destination_Offset.Off_High = INITIAL_REGISTER_SPACE_HI;
pIrb->u.AsyncWrite.DestinationAddress.IA_Destination_Offset.Off_Low =
pDevExt->BaseRegister + FIELDOFFSET(CAMERA_REGISTER_MAP, CurrentVFrmRate);
pIrb->u.AsyncWrite.nNumberOfBytesToWrite = sizeof(ULONG);
pIrb->u.AsyncWrite.nBlockSize = 0;
pIrb->u.AsyncWrite.fulFlags = 0;
InterlockedExchange(&pIrb->u.AsyncWrite.ulGeneration, pDevExt->CurrentGeneration);
break;
case DCAM_RUNSTATE_SET_FRAME_RATE:
//
// Bit[24..26]0:0000 = CurrentVideoMode
//
pDCamIoContext->RegisterWorkArea.AsULONG = pDevExt->CurrentModeIndex << 5;
DbgMsg2(("\'DCamToRunState: CurrentVideoMode %x\n", pDCamIoContext->RegisterWorkArea.AsULONG));
pIrb->u.AsyncWrite.DestinationAddress.IA_Destination_Offset.Off_Low =
pDevExt->BaseRegister + FIELDOFFSET(CAMERA_REGISTER_MAP, CurrentVMode);
break;
case DCAM_RUNSTATE_SET_CURRENT_VIDEO_MODE:
pDCamIoContext->RegisterWorkArea.AsULONG = FORMAT_VGA_NON_COMPRESSED;
DbgMsg2(("\'DCamToRunState: VideoFormat %x\n", pDCamIoContext->RegisterWorkArea.AsULONG));
pIrb->u.AsyncWrite.DestinationAddress.IA_Destination_Offset.Off_Low =
pDevExt->BaseRegister + FIELDOFFSET(CAMERA_REGISTER_MAP, CurrentVFormat);
break;
case DCAM_RUNSTATE_SET_CURRENT_VIDEO_FORMAT:
//
// Bit [24..27]:00[30..31] = IsoChannel:00SpeedCode
//
pDCamIoContext->RegisterWorkArea.AsULONG = (pDevExt->IsochChannel << 4) | pDevExt->SpeedCode;
DbgMsg2(("\'DCamToRunState: pDevExt->SpeedCode 0x%x, Channel+SpeedCode %x\n", pDevExt->SpeedCode, pDCamIoContext->RegisterWorkArea.AsULONG));
pIrb->u.AsyncWrite.DestinationAddress.IA_Destination_Offset.Off_Low =
pDevExt->BaseRegister + FIELDOFFSET(CAMERA_REGISTER_MAP, IsoChannel);
break;
case DCAM_RUNSTATE_SET_SPEED:
//
// Bit[24]000:0000 = start ? 1 : 0;
//
pDCamIoContext->RegisterWorkArea.AsULONG = START_ISOCH_TRANSMISSION;
pIrb->u.AsyncWrite.DestinationAddress.IA_Destination_Offset.Off_Low =
pDevExt->BaseRegister + FIELDOFFSET(CAMERA_REGISTER_MAP, IsoEnable);
break;
case DCAM_RUNSTATE_SET_START:
pStrmEx = (PSTREAMEX) pDevExt->pStrmEx;
ASSERT(pStrmEx);
pStrmEx->KSState = KSSTATE_RUN;
// If this is called from a SRB, then completed it.
if(pDCamIoContext->pSrb) {
pDCamIoContext->pSrb->Status = pIrp->IoStatus.Status == STATUS_SUCCESS ? STATUS_SUCCESS : STATUS_UNSUCCESSFUL;
COMPLETE_SRB(pDCamIoContext->pSrb);
}
//
// This is last stop; so
// we free what we allocated.
//
DbgMsg2(("\'DCamToRunStateCR: DONE!\n"));
DCamFreeIrbIrpAndContext(pDCamIoContext, pDCamIoContext->pIrb, pIrp);
return STATUS_MORE_PROCESSING_REQUIRED;
default:
ERROR_LOG(("DCamToRunStateCR:DeviceState(%d) is not defined!\n\n", pDCamIoContext->DeviceState));
ASSERT(FALSE);
return STATUS_MORE_PROCESSING_REQUIRED;
}
pDCamIoContext->DeviceState++; // Keep track of device state that we just set.
if(pIrb->FunctionNumber == REQUEST_ASYNC_WRITE) {
pIrb->u.AsyncWrite.Mdl =
IoAllocateMdl(&pDCamIoContext->RegisterWorkArea, sizeof(ULONG), FALSE, FALSE, NULL);
MmBuildMdlForNonPagedPool(pIrb->u.AsyncWrite.Mdl);
}
NextIrpStack = IoGetNextIrpStackLocation(pIrp);
NextIrpStack->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL;
NextIrpStack->Parameters.DeviceIoControl.IoControlCode = IOCTL_1394_CLASS;
NextIrpStack->Parameters.Others.Argument1 = pIrb;
IoSetCompletionRoutine(
pIrp,
DCamToRunStateCR,
pDCamIoContext,
TRUE,
TRUE,
TRUE
);
Status =
IoCallDriver(
pDevExt->BusDeviceObject,
pIrp
);
DbgMsg2(("\'DCamToRunStateCR: IoCallDriver, Status=%x; STATUS_PENDING(%x)\n", Status, STATUS_PENDING));
return STATUS_MORE_PROCESSING_REQUIRED;
}
VOID
DCamSetKSStateRUN(
PDCAM_EXTENSION pDevExt,
IN PHW_STREAM_REQUEST_BLOCK pSrb // Needed only to complete the SRB; for bus reset, there is no SRB.
)
/*++
Routine Description:
Set KSSTATE to KSSTATE_RUN.
Can be called at DISPATCH level for initializing the device after a bus reset.
Arguments:
pSrb - Pointer to Stream request block
Return Value:
Nothing
--*/
{
PSTREAMEX pStrmEx;
PIRB pIrb;
PIRP pIrp;
PDCAM_IO_CONTEXT pDCamIoContext;
PIO_STACK_LOCATION NextIrpStack;
NTSTATUS Status;
ASSERT(pDevExt);
pStrmEx = (PSTREAMEX) pDevExt->pStrmEx;
ASSERT(pStrmEx);
if(!DCamAllocateIrbIrpAndContext(&pDCamIoContext, &pIrb, &pIrp, pDevExt->BusDeviceObject->StackSize)) {
if(pSrb) {
pSrb->Status = STATUS_INSUFFICIENT_RESOURCES;
COMPLETE_SRB(pSrb);
}
return;
}
pStrmEx->KSStateFinal = KSSTATE_RUN;
pDCamIoContext->DeviceState = DCAM_RUNSTATE_SET_REQUEST_ISOCH_LISTEN;
pDCamIoContext->pSrb = pSrb; // To do StreamClassStreamNotification()
pDCamIoContext->pDevExt = pDevExt;
pIrb->FunctionNumber = REQUEST_ISOCH_LISTEN;
pIrb->Flags = 0;
pIrb->u.IsochStop.hResource = pDevExt->hResource;
pIrb->u.IsochStop.fulFlags = 0;
NextIrpStack = IoGetNextIrpStackLocation(pIrp);
NextIrpStack->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL;
NextIrpStack->Parameters.DeviceIoControl.IoControlCode = IOCTL_1394_CLASS;
NextIrpStack->Parameters.Others.Argument1 = pIrb;
// In case we time out, we will try again; apply only to start listen;
// With little change, it can work with other operation as well.
pDevExt->lRetries = 0;
IoSetCompletionRoutine(
pIrp,
DCamToRunStateCR,
pDCamIoContext,
TRUE,
TRUE,
TRUE
);
Status =
IoCallDriver(
pDevExt->BusDeviceObject,
pIrp
);
}
VOID
DCamReceiveCtrlPacket(
IN PHW_STREAM_REQUEST_BLOCK pSrb
)
/*++
Routine Description:
Called with packet commands that control the video stream
Arguments:
pSrb - Pointer to Stream request block
Return Value:
Nothing
--*/
{
PDCAM_EXTENSION pDevExt;
PSTREAMEX pStrmEx;
//
// determine the type of packet.
//
PAGED_CODE();
pSrb->Status = STATUS_SUCCESS; // default; called functions depends on this.
pDevExt = (PDCAM_EXTENSION) pSrb->HwDeviceExtension;
ASSERT(pDevExt);
pStrmEx = (PSTREAMEX) pDevExt->pStrmEx;
ASSERT(pStrmEx);
switch (pSrb->Command) {
case SRB_GET_STREAM_STATE:
VideoGetState (pSrb);
break;
case SRB_SET_STREAM_STATE:
if(pStrmEx == NULL) {
ERROR_LOG(("\'DCamReceiveCtrlPacket: SRB_SET_STREAM_STATE but pStrmEx is NULL.\n"));
ASSERT(pStrmEx);
pSrb->Status = STATUS_UNSUCCESSFUL;
break;
}
DbgMsg2(("\'DCamReceiveCtrlPacket: Setting state from %d to %d; PendingRead %d\n",
pStrmEx->KSState, pSrb->CommandData.StreamState, pDevExt->PendingReadCount));
//
// The control packet and data packet are not serialized by the stream class.
// We need to watch for PAUSE->STOP transition.
// In this transition, SRB_READ can still come in in a separate thread if
// the client application has separate threads for setting state and read data.
//
// A "stop data packet" flag and a mutex is used for this synchronization.
// So we set "stop data packet" flag to stop future read, and
// wait to own the mutex (if read is in progress) and then set stream to STOP state.
// This "stop data packet" flag can be the stream state.
//
switch (pSrb->CommandData.StreamState) {
case KSSTATE_STOP:
DCamSetKSStateSTOP(pSrb);
return; // Complete Asynchronously in IoCompletionRoutine*
case KSSTATE_PAUSE:
DCamSetKSStatePAUSE(pSrb);
return; // Complete Asynchronously in IoCompletionRoutine*
case KSSTATE_RUN:
DCamSetKSStateRUN(pDevExt, pSrb);
return; // Complete Asynchronously in IoCompletionRoutine*
case KSSTATE_ACQUIRE:
pSrb->Status = STATUS_SUCCESS;
break;
default:
ERROR_LOG(("\'DCamReceiveCtrlPacket: Error unknown state\n"));
pSrb->Status = STATUS_NOT_IMPLEMENTED;
break;
}
pStrmEx->KSState = pSrb->CommandData.StreamState;
break;
case SRB_GET_STREAM_PROPERTY:
DbgMsg3(("\'DCamReceiveCtrlPacket: SRB_GET_STREAM_PROPERTY\n"));
VideoGetProperty(pSrb);
break;
case SRB_INDICATE_MASTER_CLOCK:
//
// Assigns a clock to a stream
//
VideoIndicateMasterClock (pSrb);
break;
default:
//
// invalid / unsupported command. Fail it as such
//
pSrb->Status = STATUS_NOT_IMPLEMENTED;
break;
}
StreamClassStreamNotification(StreamRequestComplete, pSrb->StreamObject, pSrb);
}